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PRESENTAZIONE 


Due brevi righe per presentare questa traduzione, che é sta- 
ta fatta per uso personale (e si vede...?1) e che ora trami- 
te l'Amico e Texano Giancarlo ANTICI di Roma, autore di al- 
tre traduzioni éul TI-99/4A (1), ho deciso di mettere a di- 
sposizione degli altri Amici Texani, a cui spero possa essere 
di aiuto nella comprensione di questo benedetto linguaggio 
ASSEMBLY, 


E' la mia seconda esperienza, dopo la traduzione del manuale 
operativo del programma di grafica "GRAPHKX". 


Spero che il risultato della traduzione sia leggibile e com- 
prensibile a tutti, nonostante qualche manchevolezza che po- 


trà apparire qua e là, ma che mi auguro non pregiudichi il 
suo insieme. 


Ennio MEDICI 

via Stazione 21 
18030 BEVERA (IM) 
tel. 0184/210068 


(1) Libri disponibili presso Giancarlo ANTICI 
via G. Cardano 170 
00146 Roma 
— M.S. MORLEY 
Fundamentals of TI-99/4A Assembly Language 
— AMROUCHE £ DIDI 
Initiation au langage Assembleur du TI-99/4A 


Downloaded from www.ti99iuc.it 


N.B? per un salto nella numerazione la pag. 63 non esiste e 
si passa quindi direttamente da pag. 62 a paz. 64. 
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CAPITOLO PRIMO 
INTRODUZIONE 


Lo scopo di questo libro, come e' inplicito dal suo titolo, e’ di 
:ntrodurvi nell'uso del TI-99/4A con il LINGUAGGIO ASSEMBLY DEL TM59900, e farvi 
‘iniziare a scrivere programmi in ASSEMBLY con il minimo sforzo. 

I aanuali forniti con i package dell'EDITOR /ASSEMBLER, (E/A) e MINI MEMORY 
M/M) sono soltanto dei manuali di riferimento. Essi presumono che voi abbiate una 
:ualche conoscenza di programmazione in ASSEMBLY, Naturalaente questo crea dei 
:roblemi per i principianti. Ora questo libro puo' fungere come supplemento per darvi 
.na aigliore conoscenza generale, e la capacita' necessaria per capire e utilizzare 
:eglio il vostro manuale dell’E/A 

Al termine di questo volumetto sarete in grado di decifrare senplici 
irogranmmi in LINGUAGGIO ASSEMBLY del TMS9900, e userete meglio il vostro E/A, oa 
. Assembler LINEA per LINEA della M/M, e i manuali di riferimento per sviluppare 
:rograami e routines piu' complessi... almeno spero. (Nota del traduttore) 


E' meglio leggere questo libro dall'inizio, perche' ogni lezione e’ basata 
:u quella precedente e gli esempi dei prograami spiegano le funzioni descritte fino a 
.uel punto. Per sfruttare al meglio questo libro dovrete avere il software e il 
«anuale dell’E/A. Quelli che non possiedono le periferiche necessarie per usare 
iuesto software, (Espansione di aemoria 32K e disk driver) potranno usare il modulo 
sella M/M per inserire molti esempi di prograaai. In questo libro quando e' nominato 
.'ASSEMBLER LINEA PER LINEA, esso verra' assegnato al programma ASSEMBLER che e' 
‘ornito con la M/M. L' ASSEMBLER LINEA PER LINEA ha certe limitazioni, che vengono 
:escritte piu' avanti, ma i concetti dei programai ASSEMBLY sono gli stessi dell'E/A. 

Alla fine di ogni sezione ci sono informazioni di riferiaento al manuale 
.el1'E/A, dove potranno essere trovate inforaazioni supplementari. 


Prima di procedere con questo lavoro, voi dovreste prendere confidenza con 
.'uso del TI BASIC. Esattamente come un linguaggio BASIC varia da un computer 
ill’altro, così’ sono anche i linguaggi ASSEMBLY. Ma se siete in grado di imparare 
-.na forma di linguaggio, sara' semplice applicare cio' che avete iaparato ad un'altro 
inguaggio sinile, Ora voi dovrete avere un p@'o' d'esperienza di programmazione con 
aaplici programei in TI BASIC, e EX/BASIC. Voi noterete che 1'ASSEMBLY e' assai piu' 
ntente del BASIC, Ma egli e' un linguaggio del computer, e come tutti, ha norrme, 
.iscipline e termini particolari che dovranno essere imparati un p@’o' per volta. Una 
:olta imparato piu' di un paio di linguaggi del computer, le rasso@giglianze tra loro 
saranno piu' evidenti delle differenze. 


PASSARE_DAL_BASIC_ALL' ASSEMBLY 

Le istruzioni dei programai che avete scritto fin'ora in TI BASIC, prese 
‘osi’ coae sono, non hanno alcun significato per il computer. Ogni istruzione deve 
:ssere tradotta in un linguaggio che il computer capisca, cioe’ il “LINGUAGGIO 
{ACCHINA"., Un linguaggio al livello macchina e' detto anche "LINGUAGGIO di BASSO 
-IVELLO". Un linguaggio come il TI BASIC che assomiglia molto a frasi in inglese, 
‘iene chiamato anche “LINGUAGGIO ad ALTO LIVELLO". Il processo di interpretazione 
iene realizzato da un sistema di prograani, subroutines, e di dati, collocati nel 
-onputer dal fabbricante. Questo sistema e' conosciuto come "INTERPRETE BASIC". 


L'interprete analizza ogni istruzione BASIC e converte queste istruzioni ad 
alto livello in un set di istruzioni a basso livello (0 linguaggio macchina), che sono 
quelle che realmente fanno funzionare il computer. Non iaporta quale linguaggio di 
programmazione ad alto livello usiate, TUTTI devono essere tradotti nel codice 
macchina compreso dal computer. Il lavoro necessario per eseguire questo processo di 
interpretazione di come ogni istruzione viene eseguita e' la Causa per cui i progranni 
scritti in BASIC o altri linguaggi ad alto livello girano piu' lentamente di un 
progranma scritto in linguaggio macchina. 


Il processo ASSEMBLY esigliora enormemente la velocita' del progranma. 
Quest'ultimo scritto in ASSEMBLY e' assemblato dall’assenbler pressapoco come 
l'interprete tratta un programma in BASIC. Comunque con l’ASSEMBLY, il set risultante 
dei codici macchina puo' essere salvato su alcuni dispositivi per poterli 
riutilizzare. Poì, quando il programaa viene fatto girare, non ci sara* alcun 
intermediario, come nel BASIC. Il codice macchina e' direttamente eseguibile dal 
computer, che cosi’ eseguira' aolto velocemente il prograama caricato. Molti giochi, 
tipo arcade, e alcuni programmi applicativi scritti nel linguaggio ASSEMBLY del 
TMS9900, richiedono subroutines per rallentarli, perche ‘* troppo veloci. 


Le istruzioni contenute in un programma scritto in linguaggio ad alto 
livello, come il TI BASIC, sono soltanto la sorgente del sateriale dal quale poi viene 
generato il programma in linguaggio macchina. Nel linguaggio ASSEMBLY, il prograana 
che voi codificate, viene chiamato * PROGRAMMA SORGENTE” o "CODICE SORGENTE" Quello 
assemblato dal vostro codice sorgente, e' chiamato "PROGRAMMA OGGETTO” o “CODICE 
OGGETTO”. Poiche' essi sono sempre salvati su qualche dispositivo, potranno anche 
essere chiamati "FILE SORGENTE, o FILE OGGETTO". Dopo che il vostro programma in 
linguaggio ASSEMBLY e' stato assemblato, esso esiste in due forae: Il codice SORGENTE 
originale rimane immutato, mentre viene creato un nuovo file contenente il codice 
OGGETTO. ‘(L’'assembler linea per linea, come dice il suo noae, crea il codice aacchina 
quando voi inserite la linea, così° il codice sorgente non e’ salvato come file 
separato). 


Oltre all’interpretazione, durante la sua esecuzione, in un linguaggio 
BASIC, vi sono anche altri inconvenienti. Il progranaa BASIC necessita di un vasto e 
sofisticato "Cast di supporto” hardware e software per farlo funzionare bene. Questo 
richiede che una parte delle risorse del computer siano dedicate a questo scopo, 
percio" non utilizzabili alle applicazioni del prograama. Il TI BASIC e' progettato 
per essere facilmente leggibile dall’uoao. Sono usate parole comuni (Per gli 
Inglesi,pero'. N.d.T.), come PRINT, FOR, NEXT e DATA, e le istruzioni possono essere 
lette come una comune frase, (Sempre per gli Inglesi, N.d.T) 

Questo sodo di rappresentare le istruzioni e i dati per un essere umano, non 
e' necessariamente il modo piu' efficente per rappresentare la stessa informazione ad 
una macchina. Un prograama in BASIC relativamente corto, aolte volte produce piu' 
istruzioni macchina del numero di istruzioni BASIC che lo compongono. 

Un'unica istruzione cone: 

10 INPUT X 

Richiede molte istruzioni macchina per eseguire il compito stabilito. Il 
grado di complessita’ coinvolto nell'esecuzione di una istruzione BASIC non e‘ 
visibile dal programaatore in BASIC. 

Molti programmatori, ritengono che il BASIC incoraggi la gente a creare 
programmi non particolarmente efficenti, e che potrebbero essere trascurati, se 
paragonati allo stesso prograama in ASSEMBLY. 
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Il LINGUAGGIO ASSEMBLY non e' un linguaggio aacchina. E° ad un livello 
piu' alto, ma e' piu' vicino al linquaggio macchina del BASIC, percio' e' possibile 
scrivere programmi piu' efficenti in linguaggio ASSEMBLY che in BASIC. 


Il CODICE OGGETTO occupa molto meno spazio in memoria, e su un dispositivo 
di memorizzazione, del CODICE SORGENTE. Una riduzione importante nel numero dei bytes 
richiesti per memorizzare ed eseguire un programma, lascia liberi piu' risorse e 
potenza in un computer, per la memorizzazione e la manipolazione dei dati. 

Con il modulo dell'’E/A e' possibile produrre il CODICE OGGETTO in formato 
COMPRESSO. Questo riduce anche ulteriormente le dimensioni del FILE OGGETTO per le 
esigenze di memorizzazione. Come si comprende subito, qualsiasi programma che viene 
scritto in maniera piu' corta e piu' semplice, girera' piu' velocemente, e usera' meno 
memoria. 


Vi e' anche il rovescio della medaglia, naturalmente. In un linguaggio ad 
alto livello, come il TI BASIC, voi potete scrivere i progranai in semplici e corte 
istruzioni in Inglese, le quali possono affrontare alcuni compiti complessi in poche 
linee. E, modificare quelle istruzioni e’ senplice poiche’ voi non dovrete 
riasseablare il vostro prograaaa priaa di farlo girare. Potrete senplicemente battere 
RUN per vedere i risultati delle modifiche. 

Con il liguaggio ASSEMBLY voi non avrete da codificare centinaia di 
istruzioni, ma dovrete codificare molte piu' dichiarazioni che in BASIC. Voi 
necessiterete di essere molto piu' specifici ed avere una maggiore capacita’ di 
comprensione del vostro codice. Con il TI RASIC voi siete isolati da come lavora il 
computer. Non avete bisogno di sapere niente su come esso esegue i comandi che voi 
gli date, a voi bastera' solo conoscere la sintassi dei comandi dati per vedere dei 
risultati. 


Con la programmazione in linguaggio ASSEMBLY, VOI siete al comando del 
computer, ed esso sara’ a vostra completa disposizione. Pero’ avrete bisogno di 
conoscere qualche altra cosa sui dettagli interni del computer. 

Il valore dei particolari in un programma ASSEMBLY, sara’ sempre maggiore di 
un’equivalente in BASIC. La maggior parte delle subroutine e dei programai di 
Supporto a cui eravate abituati in BASIC ed EX/BASIC qui* non ci sono. Voi dovrete 
progettare le vostre routines secondo le vostre necessita'. 

Questo potrbbe sembrare un’inconveniente, o fastidio, ma e’ realmente 
indicativo del grado di potenza che vi viene consegnato con il linguaggio ASSEMBLY. 
Voi avete l'opportunita’ di usare la vostra creativita’ progettando qualsiasi routines 
che serva al vostro uso e consumo. Potrete personalizzare molte delle funzioni che 
sono provviste per voi in BASIC. Downloaded fromwww.ti99iuc.it 


Non abbiate timore dell'ASSEMBLY. All'inizio puo' sembrare opprimente, na 
imparerete presto ad apprezzare tutto quello che esso puo' fare per voi,poiche' aette 
tutta la potenza del computer alla vostra portata. Vi sara' richiesto di piu' dalla 
vostra abilita’ di prograanatore, ma molto di piu’ vi sara’ consegnato. La 
rincompensa vi giungera' in fretta, sotto forma di accresciuta capacita’, ed 
apprezzamento di come il computer esegue i compiti che voi gli date. 


MANUALE DI RIFERIMENTO EDITOR/ASSEMBLER. 


I seguenti riferimenti vi forniscono altre informazioni sul processo ASSEMBLY. 


SEZIONE 1-1....Pag. 15 
SEZIONE 15-1...Pag. 235 


Leggere i seguenti termini sul GLOSSARIO. 


ASSEMBLER 

ASSEMBLING 

ASSEMBLY LANGUAGE 
COMPRESSED OBJECT CODE 
MACHINE LANGUAGE 
OBJECT CODE 

SYNTAX 

SYNTAX DEFINITION 
TMS9900 Microprocessor 


CAPITOLO SECONDO 
NOTAZIONE BINARIA ED ESADECIMALE 


Prima che possiate iniziare a programmare il vostro computer in un 
linguaggio di basso livello, come l'ASSEMBLY, e’ importante capire come esso 
rappresenta ed elabora l'informazione. 

Conoscendo come il vostro coaputer "pensa", voi potete orientare il vostro 
pensiero, e quindi l'approccio alla programmazione al livello della macchina sara' 
piu’ facile. Attualmente il linguaggio macchina e’ in forma BINARIA. Esso si 
riferisce al sistema di numerazione su cui sono basati i computers’, cioe’, il 
CODICE BINARIO, o a BASE 2. Qualche conoscenza di questo sistema e’ necessaria per 
programmare in ASSEMBLY. 


Un computer potrebbe essere ritenuto un vasto insiene di interruttori in 
miniatura, ciascuno dei quali puo’ essere acceso o spento. Ognuno di questi 
interruttori puo' essere paragonato ad un BIT. La condizione di acceso o spento di un 
BIT puo' rappresentare molte cose: SI/NO, ALTO/BASSO, CALDO/FREDDO, o i valori di UNO 
e ZERO (che sono poi i valori che a noi interessano). Se un BIT e* ACCESO esso 
rappresenta UNO, se e' SPENTO, indica ZERO. Questo, naturalmente perche’ solo due 
numeri sono usati (zero e uno), ed e* percio’ che viene chiamato BINARIO. 

Se voi considerate una serie di BITs, presi come un'unita', o come un valore 
espresso in forma binaria, grandi valori possono esere interpretati dagli stati 
"acceso/spento"” di una serie di BITs, 


Il sistema di numerazione che normalaente usiamo e'* il SISTEMA DECIMALE, 
cioe” con BASE 10. @uando rappresentiamo un valore nunerico decimale i simboli dei 
numeri rappresentano la potenza del "10". cosi’ il numero “2139” puo'eessre scritto 
come segue: 


105 = 1000 = 21000 = 2000 

10? = 100 = 1% 100= 100 

103 = 10 = 3 10= 30 

100 = 1 = 9% 13 09 
2139” 


Le stesse regole vengono applicate ai sistemi numerici con base diversa da 
dieci, 

Se voi state trattando con nuaeri significativi, avrete bisogno di piu' di 
un bit per poterlo fare, perche’ un bit puo' solo indicare 1 00. 

Un BYTE e' una serie di OTTO BIT.SEDICI BIT sono uguali a DUE BYTEs, o una 
WORD. Qui c’e’ un BYTE rappresentato da otto nuneri, ciascuno dei quali puo' solo 
essere un uno oO uno zero, 

00001101 


In un sistema binario, ogni posizione rappresenta un’esponente della potenza 
di 2. Proprio come qualsiasi altro sistema numerico, la posizione degli zeri non ha 


D) 


effetto sul valore dell'espressione, in tal aodo per l'appunto esaminate i 
quattro bit piu’ a destra. Cuesti sono anche detti BIT DI PESO MINORE o MENO 
SIGNIFICATIVI. 


VALORE DEL BIT i 1 164 i 
VALORE DEL POSTO otto quattro due uno 
BASEssponente 23 22 2° 2 


Gli stati "acceso/spento" di questi bits rappresentano il valore "13", se 
presi come numero binario. Ecco come potete indicare questo valore nel 
sistema decimale: 


1*8 = 8 
184 = 4 
0#+£2 = 0 
131 = I 
“0 13 
Che valore contiene questo BYTE ? 
00000110 


La risposta e’ SEI. Sapete perche'?. E che ne dite di questo BYTE ? 
OOU0IIII 


Se avete detto "15", allora siete sulla strada giusta E di quest'altro 
BYTE? 


00000001 
Bene, uno e' sempre uno, anche in binario. 


Mentre la notazione binaria applica prontamente gli stati di "acceso/spento"” 
dei bits, scrivere tutti i valori nel formato binario puo’ essere molto fastidioso, 
perche' e molto facile confondersi con tutti quegli zeri e uno, per cui normalaente si 
usa la "NOTAZIONE ESADECIMALE"” o "BASE 16°. 

Ancora una volta ogni cifra in notazione ESADECIMALE rappresenta una potenza 
della base, che e* SEDICESIMA. Il valore dell'esponente in relazione alla posizione 


di ogni numero esadecimale dovrebbe essere: 


VALORE DEL POSTO 4096 256 16 1 
BASE=sponente 165 162 16% 14° 


I numeri ESADECIMALI nel linguaggio ASSEMBLY del TI-99/4A vengono indicati 
con il sinbolo "MAGGIORE DI" (*>"), che precede il numero. Per es. il numero ")10" 
e' esadecimale, e corrisponde al decimale "16". Usando il aodello esposto sopra, il 
numero a destra e' uguale a "0" percio‘ zero, mentre il numero a sinistra sara’ "1° 
uguale a 16. Sommando i due numeri si ha alla fine 16+0 = 16, cioe', HEX DIO. 
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Nel sistema decimale sono necessari 10 simboli (da 0 a 9) per indicare i valori. 
Con il sistema esadecimale (HEX) servono SEDICI simboli, cioe' da 1 a 9 come nel 
sistema decimale, e poi le prime SEI lettere dell’alfabeto per (A-F) indicare le 
rimanenti 6 cifre. 


Cosi'A rappresenta ili0, B rappresenta l'’1i, ecc. fino ad F per il 15 


Il valore quindici nel codice binario occupa quattro cifre:ilii. Nel codice HEX 
questo valore puo' essere indicato con una sola cifra: F. Cosi” un byte di dati viene 
indicato con due sole cifre, mentre in binario occorrono ben OTTO cifre, cioe’ uni e 
zeri. Questo e' ovviamente un sistema piu‘ efficente di esprimere i valori. Ecco 
alcuni esenmpi. 


DECIMALE BINARIO ESADECIMALE 
1 00000001 >01 
2 00000010 >02 
3 00000011 )03 
4 00000100 > 04 
Lo) 00000101 }05 
) 00000110 )06 
È 00000111 >07 
8 00001000 )08 
9 00001001 >09 

10 00001010 >0A 
Il OOO0IO1I >0B 
12 00001100 > OC 
13 00001101 >OD 
14 00001110 > OE 
15 00001111 >OF 
16 00010000 >10 
32 00100000 > 20 
33 00100001 21 


Il valore piu' grande che puo’ essere rappresentato con un byte (otto bit) e' il 
Binario illillii, Hex >FF, o Deciamale 255. Se voi espriaete una WORD (sedici bit) 
come espressione binaria, allora il valore piu’ grande di una WORD sara’ 
1ililll1l11111111, Hex >FFFF, o Decimale 65.535. Anche valori piu' grandi potranno 
essere impiegati, usando due o piu' WORD successive. 

Per indicare se il valore di un nuaero e' positivo o negativo si usa il bit di 
sinistra del byte. Se questo bit e' OFF (spento) = ZERO, allora il valore 
rappresentato dai bit precedenti e' positivo. Se invece questo bit e’ ON (acceso) = 
UNO, allora il valore e‘ negativo. 

Il numero Binario indicato dai sedici bit Olliillililililtiti sara’ uguale a 
+32.767. Per i numeri piu' grandi di 32.767 il bit sinistro, o BIT DI SEGNO, dovra' 
essere usato.Per evitare conflitti i numeri piu' grandi di 32.767 vengono indicati 
come nuaerì NEGATIVI di COMPLEMENTO A DUE. 

«Il COMPLEMENTO A DUE, e' aolto utile al computer per trattare con l'’aritmetica 
binaria. 


Supponete di voler calcolare "i6 - 10”. Il computer non puo' fare la 
sottrazione, ma dovra’ invece compiere un'addizione in COMPLEMENTO A DUE. Il valore 
da essere sottratto viene convertito nel formato "Complemento a due", e addizionato al 
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primo valore. Cio’ da lo stesso risultato della sottrazione. Poiche' questo e‘ 
logicamente lo stesso che negare il secondo valore, e addizionarlo. 


Per affrontare il problema di cui sopra, esaminiamo i valori del bit, prima, 
durante e dopo il conplemento aritmnetico a due. Dal momento che usiamo numeri 
abbastanza piccoli, possiamo usare un byte (otto bits) per indicare ciascun totale. 


BINARIO DECIMALE HEX 
VALORE 1 00010000 16 >10 
VALORE 2 00001010 10 >OA 


Primo, invertire tutti i bits 1 in 0, e i bits 0 in I per il valore 2 
0000LOL0 diventa 11110101 


Notate che il primo bit a sinistra, adesso e' i, dando a tutto il byte un 
valore negativo. fdesso addizionate uno al valore. 


11110101+ 


11110110 


Il valore 2 e* ora nel formato COMPLEMENTO A DUE . Ora addiziona il valore 
1 a questo. 


00010000+ 
11110110= 


10000110 


Trascurate il bit di sinistra, che e' stato riportato. I bit rimanenti sono 
0000110 binario, cioe' uguale a SEI decimale. Infatti 16-10=è. Il computer usa il 
conplemento a due per i numeri negativi e per qualsiasi valore piu' grande di 32.767. 
Questo e' importante per voi quando desiderate scrivere indirizzi maggiori di 32.767 
nel formato decimale, in programmi che accedono a indirizzi specifici. 

Una regola molto facile da sequire e' questa: PER QUALSIASI INDIRIZZO MAGGIORE DI 
32.767, SOTTRARRE 65.536 DALL' INDIRIZZO. 

Per esempio: per aettere il valore 79 all'indirizzo 33.008, usando la formula di 
cui sopra, si avra’ 33.008 - 65536 = -3532528 il codice dell'EX/BASIC dovrebbe 
assomigliare a questo: 


10 CALL LOAD(-32.528,79) 


Molto probabilmente sara’ questo il maggior uso che farete della notazione in 
complemento a due, usando la notazione decimale per indicare gli indirizzi maggiori di 
32.767, 

Il complemento a due non si usa con la notazione esadecimale, infatti essa tratta 
i numeri piu' grandi di 32.747 senza nessun problena. 

Esaminate questi esempi, e fate pratica esercitandovi a scrivere numeri in 


g 


‘otazione binaria e esadecimale. Scrivete ,per esenpio , la vostra eta' ‘in ogni 
‘otazione, oppure provate qualsiasi altro valore fanmiliare. Ricordatevi che il 
rocedimento e' lo stesso per ogni sistema numerico, cambia solo la base della potenza 
:he ogni numero rappresenta. 


Se proprio non vi riesce vi sono dei calcolatori appositi che fanno la 
:onversione da una base all'altra (ed esistono anche dei programmi per il TI-99/4A che 
‘anno la stessa cosa. N.d.T.) 


Proprio come qualsiasi altra cosa, la notazione esadecimale diventa piu' facile 
an mano ci si esercita con essa. Il linguaggio ASSEMBLY del TMS9900 vi permettera’ 
i indicare i valori in decimale, se voi lo desiderate, ma siccome la rappresentazione 
nterna del computer e' la notazione binaria, usando i numeri Hex si e’ piu' vicini al 
.u0 modo di operare. 


Ecco qui’ sotto quattro problemi in aritaetica esadecimale, controllate se siete 
.n grado di capirli. 


1) >6800+ 2) 3>7402+ 3) )DO66+ 4) )OFAB+ 
>029A= >0EF0= >110C= )0A95= 
#55 sic na = “97° 


Ricordatevi che il simbolo (>) viene usato per indicare i numeri esadecìimali, 
“oiche' questo e’ un sistema di numerazione in base 16, ci saranno poche differenze 
:on l'aritaetica decimale. L'unica cosa che piu' confonde i principianti, sono le 
.ettere da "A" ad "F", che qui' prendono il posto dei numeri da 10 a 15. Ecco un 


‘amplice esempio di addizione Hex e decimale. 


ESADECIMALE DECIMALE 

)9 + di = dA 9+1= 10 
2A + dI = >B 10 +1= 1 
>)B + dI = DC ii +1=12 
>C + dI = )D 12+1= 15 
>D + dI = DE 13 + 1 = 14 
)E + }L = )F 14 +13 15 
DF + di = 210 15 +1= 16 


Notate che nel sistema decimale, dovete arrivare fino a nove prima di poter 
iggiungere una unita’ alle decine, ed uno zero al posto delle unita’. Nel sistema HEX 
juesto numero e‘ il QUINDICI (F), e vi e' il riporto di uno per indicare SEDICI, non 
J5IECI, perche’, ricordate, siamo in un sistema con base 16. 


Controlliamo prima il problema i: noterete che i numeri sono incollonati da 
iestra a sinistra, proprio come una addizione decimale. 


> 6800 


> 025A 


> 6A3 
| 0+A= DA 
0+9= 99 
8+2= DA 
8+0= 6 
— I6ATA 


Ora saltate al problema 3. Nella colonna a destra vi e' la somma di 6 + C, cioe' 
6 + 12 = 18, cosi’ il riporto di uno viene messo sulla colonna subito alla sua 
sinistra. Il valore dell'uno riportato e' 16, perche’ siamo in base 16, erentre il 
risultato della somma e' 2 (infatti 18 - 16 = 2). 


)DO66+ 
>L110C= 


| òo+C= ?2 


16+1 riporto +0 = )7 
0+1=)I 
D+ 1=E 
"DE172” 


Nel problema 4, la sottrazione si svolge in maniera simile. 


>OFFB- 

)0A95= 

)0566 © 

le B- S= >é 
F-9= dé 
F-A=  )S 
0-0 = Do 
“30566. 


Tornando indietro al probleaa 2, esaminate come si svolge la sottrazione. Nella 
seconda colonna da destra ,0 - )F un uno dovra‘ essere preso in prestito dalla colonna 
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alla sua sinistra. Questo valore preso a prestito e' SEDICI (ricordate sempre, Siano 
in base 16), percio* SEDICI ameno QUINDICI = 1. Dopo aver preso un prestito dalla 
colonna seguente, questa diventa >3 - )E, per cui dobbiamo prendere un prestito ancora 
dalla colonna a sinistra. Addizionando SEDICI a TRE diventa DICIANNOVE, per cui 19 - 
14 (13 - DE) = S. Nell'ultima colonna a sinistra, a causa del numero prestato, si ha 
SEI - ZERO = SEI. 


)7402- 
)OEF0= 
>6512” 
a 2-0= >2 
0-Fs= >1 
4-val.prest. 
+ val.in pres.- E = )5 


7- val, prest., - 0= dé 
)6512 


Con un po’ di pratica troverete che l'’aritmetica esadecimale e’ proprio facile 
cone la decimale. Una volta che avrete preso l'abitudine ad usare i numeri HEX, non 
vi accorgerete piu' di nessuna differenza, ed usarli diventera' per voi naturale, ed 
e' meglio, perche' questo modo di rappresentare i BYTEs e le WORDs dei dati, vi dira' 
parecchie cose sullo stato dei bits, in poco spazio. Trovate un po’ di tempo per fare 
pratica, addizionando e sottraendo numeri HEX) 


MANUALE DI RIFERIMENTO E/A 


I seguenti riferimenti vi forniranno altre inforaazioni sui numeri BINARI ed 
ESADECIMALI. 


APPENDICE 
Dalla sezione 24-1,pag.393 alla sezione 24-1-4 pag.397. 


CONTROLLA QUESTI TERMINI NEL GLOSSARIO 


ASCII 

BINARIO 

BIT 

BYTE 

ESADECIMALE 

COSTANTI INTERE ESADECIMALI 
NYBBLE 

COMPLEMENTO A DUE 


T. 


CAPITOLO TÉAZO 
INDIRIZZAMENTO 


Ricordate per un momento il modello concettuale del conputer, come un grande 
insieme di microinterruttori. Questo insieme e' analogo ad una mappa di vie 
cittadine,con palazzi,incroci, e intere comunita'. Per manipolare i bits e byte dei 
dati nel computer,voi dovete fare una mappa delle risorse del computer, indicando 


certe "comunita"", e assegnando gli indirizzi a queste aree e i singoli bytes. 


Piu' avanti voi vedrete parecchi modi per specificare gli indirizzi nei programmi 
ASSEMBLY. Una saggiore attenzione ai passi del programma sara’ necessaria per 
codificare e comprendere il movimento dei dati da un’area all'altra, e) la 
manipolazione di un particolare bit, byte, o word.I] computer pretende che voi gli 
specifichiate l’esatta posizione dell’area a cui desiderate accedere, sia direttamente 
che indirettamente. Tutte le aree possibili del computer sono numerate in aodo 
univoco, per identificare ognuna di esse. Il numero da cui il computer individua ogni 
byte, e' il suo INDIRIZZO. 


Mella programmazione in linguaggio ASSEMBLY, viene usato un metodo chiamato 
“OFFSET® = “BASE PIU SPOSTAMENTO di INDIRIZ2Z20* per calcolare e nuaerare gli indirizzi 
interni. Dando un indirizzo di base conosciuto, avrete bisogno solo di calcolare il 
totale di OFFSET, o spostamento, necessario per arrivare all'indirizzo desiderato. 


Quando contate i bytes, partite con zero come primo indirizzo del primo byte. 
ZERO e‘ il primo nuaero positivo del computer, percio’, cominciate sempre a contare da 
ZERO, non da UNO. Consideriamo una area particolare della VDP RAM ( Memoria ad 
accesso casuale del processore video), nella VDP RAM, il primo byte (byte zero) 
rappresenta la prima posizione utilizzabile dello scherao. In TI BASIC questa sarebbe 
nella RIGA 1 e COLONNA 1. Un byte rappresenta un carattere. Per esempio, se il byte 
zero della VDP RAM contiene il valore >41 (0 decimale 65) la lettera "A" sara’ 
visualizzata sullo schermo alla riga 1 e colonna I. HEX >4L o decimale 65 e' il 
codice ASCII per la lettera "A". 

E' mettendo i valori corretti in questa area di VDP RAM che i sinboli ed i 
grafici sono fatti apparire sulo schermo. Molte delle funzioni che vorrete far fare 
al computer, richiederanno di mettere certi valori in questa specifica area del 
computer. 


L'area attribuita al VDP RAM e' la “TAVOLA IMMAGINE dello SCHERMO" (T.I1.5. da 
ora in avanti). Qui’ vi sono 768 bytes che rappresentano ogni posizione dello schermo 
(24 righe + 32 colonne = 768). Gli indirizzi corrispondenti nella VDP RAM vanno da Q 
a 767 decimale, (‘o da >0000 a )02FF Hex). 

Allo scopo di rendere piu' facilmente leggibile il codice nel linguaggio 
ASSEMBLY, gli indirizzi non devono essere codificati con i loro valori numerici. 
Invece voi potete associare qualche nome significativo , o etichetta, con l'indirizzo. 
Quando voi vi riferite a questa etichetta, 1‘ASSEMBLER lo traduce per indicare questo 
indirizzo. Questo puo' essere fatto con l' istruzione EQUate (eguaglia). 
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Nel Jnguaggio ASSEMBLY del TMS9900, le etichette potranno essere lunghe al 
massimo SEI caratteri ASCII. Stabilire un’etichetta per il primo byte della TIS 
(tavola immagine dello schermo). Chiamare l'indirizzo in VDP RAM, dove la TIS inizia, 
per esempio, "SCRTAB". 

Quella che segue e' un'istruzione ASSEMBLY che fa cio’: 


SCRTAB ECU >0000 


Da ora in poi voi potete riferirvi al primo byte senplicenente come SCRTAB, o 
SCRTAR+0, dove +0 rappresenta uno spostamento del valore. fddizionando +0 a SCRTAB 
non si cambiera' il valore dell'indirizzo simbolico SCRTAB. Se voi scrivete un nuaero 
di 7 cifre, nela parte alta dello schermo, esso occupera' in VDP RAM, gli indirizzi 
seguenti: SCRTAB +0, SCRTAB +1, SCRTAB +2, SCRTAB +3, SCRTAB +4, SCRTAB +5, SCRTAB +6, 
Notate che lo spostanento dei valori, i primi sette byte della VDP RAM, partono da 0 
fino a SEI. Per poter indrizzare l’ultima posizione dello scheramo (riga 24, colonna 
32)voi potete usare la notazione SCRTAB +767. Spesso un indirizzo necessaria deve 
essere calcolato da qualche indirizzo di base, e qualche spostamento del valore. 

se il numero di cui sopra, era 955351234, allora i valori dei bytes in Hex 
dovrebbero essere: 


NDIRIZZO SPOSTAMENTO VALORE BYTE INDIRIZZO CARATTERI 
SIMBOLICO VALORE HEX RELATIVO RAPPRESENTATI 
ICHETTA BASE VDP RAM DAL VALORE BYTE 
SCRTAB +0 > 35 >0900 "5" 
SCRTAB +i )55 )0001 ua 
ISCRTAB +2 ) 35 >000Z "o" 
SCRTAB +3 )31 ?>0003 0 i 
SCRTAB +4 > 32 720004 ga 
SCRTAB +5 )35 >0005 n du 
SCRTAB +ò 7354 >)0006 "4" 


Se voi descrivete al computer un algoritmo per calcolare gli indirizzi, usando 
un’indirizzo di base,voi potete avere un programma che puo’ “cercare la strada da 
solo", senza che voi dobbiate definire anticipatamente qualsiasi area interna 
necessaria. Mettete semplicemente: INDIRIZZO NUOVO = INDIRIZZO DI BASE + SPOSTAMENTO. 


Alcuni diagrammi ed esenmpi nell'ASSEMBLY del TMS9900, dividono i singoli bytes 
allo scopo di mostrare lo stato o l’importanza di ciascuno degli otto bits che 
compongono il byte. Voi noterete che i bits vengono numerati così‘: 0,1,2,3,4,5,6,7. 
Se una WORD (due bytes 0 16 bits) e divisa allora i bits sono: 
d,1,2,3,34,5,637,8,9,A,B,C,D,E,F. Questa e' un’altra applicazione dell'abitudine di 
contare sempre da zero. 

Ricordatevi sempre, pero’, che quando voi state indirizzando le aree del 
computer, i valori degli spostamenti contano i BYTEs, non BIT 


La notazione SCRTAB +2 si riferisce ad un byte con l’indirizzo di DUE bytes piu' 
distante del byte SCRTAB. Ricordatevi che nella programmazione in linquaggio 
ASSEMBLY, zero e' il numero che rappresenta sempre il primo di una serie, quando viene 
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usato nel contesto di indirizzamento o posizione. Se voi avete fatto pratica in TI 
BASIC, vi ‘ricorderete che il primo record di un FILE RELATIVO sara' sempre il record 
zero. Con l'istruzione DIM per definire una tavola, voi potete usare il parametro 
OPTION BASE 0. Questo stabilisce lo zero come primo indice di un ARRAY. (Questi sono 
tipi similiari di BASE + SPOSTAMENTO. 


MANUALE DI RIFERIMENTO E/A 
I seguenti riferimenti vi forniranno altre informazioni sull’'INDIRIZZAMENTO. 


APPENDICE 
Dalla sezione 24-2 pag.398 alla sezione 24-2-2 pag.402 


CONTROLLA QUESTI TERMINI NEL GLOSSARIO 


Indirizzi 

Modi di indirizamento 

Consolle 

CPU 

Memoria 

RAM 

ROM 

Indirizzamento simbolico della memoria 
VDP RAM 
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Le mappe della memoria possono essere cercate sui manuali dell’E/A o M/M 


Qui sotto vi e' 


>0000 >2000 
Console Memory 
ROM Expansion 
Operating "Low" RAM 
System 

GPL 

Interpreter 

BASIC . 
Interpreter 


>8300 
256 
Byte I 
CPU PAD 


>8400 


TMS9919 
Sound 
Chip 


.Service 


TMS99009 CPU MEMORY 


>4000 
Device 


>6000 
Command 
Module 
Routines ROM/RAM 
ROM ‘Mini- 
Memory 


>8000 
CPU PAD 
Memory 
Mapping 


MEMORY MAPPED PORTS 


>8809 >8C00 
VDP VDP 
Read Write 


>9009 >94290 
Read Write 


TMS9918A Video 
Display Processor 


TMS5200 
Speech 
Synthesizer 
Vocabulary 
Screen ROM 

Image (32K bytes) 
Sprite 

Attribute 

Color 

Table 

Sprite 

Descriptor 

Sprite 

Motion 

Pattern 

Generator 

Free Space 

PABs/Buffers 

Disk DSRs 


VDP RAM (16K) 
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>A000 
Memory 
Expansion 
"High" RAM 
(24K bytes) 


un altra vista dell’archittettura del TI-99/4A, 
aiutarvi nella visualizzazione delle varie locazioni di memoria. 


>98049 >9C20 
Speech Speech 0GROM GROM 
Read Write 


3 Console 
GROMS 
containing 
Monitor, 
Operating 
System and 
BASIC 
>4800 

5 Command 
Module 
GROMS 





che puo 


CAPITOLO QUARTO 
REGISTRI 


Un registro e' una speciale WORD (16 bit, 2 bytes), indicata per memorizzare, che 
ha speciali potenze e responsabilita’. Ci sono 16 REGISTRI GENERALI "WORKSPACE", 
accessibili al programmatore ASSEMBLY del TMS9900. Questi registri di uso generale 
WORKSFACE sono numerati da 0 a 15. I registri sono il WORKSPACE della CPU (Unita' di 
elaborazione centrale), o SCRATCHPAD (Buffer di memoria CPU). Essi sono usati per 
l'aritmetica, indirizzamento, e manipolazione dei bits. Essi svolgono incarichi 
speciali che altre aree del computer non possono fare. 

I registri generali WORKSPACE, occupano sempre un'area contigua di memoria, per 
un totale di >20 (532 deciaale) bytes. (QOgni registro = 16 bit, o 2 byte. 16 + 2 = 
32). Altri 52 blocchi di bytes di aemoria possono essere designati dal vostro 
programma, per essere usati come registri generali WORKSPACE. Solo un set di lé 
registri per volta puo' essere usato. 


Se voi state usando il modulo dell'E/A, scegliete l’opzione “R" quando. 
assemblate. Questo etichettera' automaticamente i 16 registri WORKSPACE come 
"RO... .R15". Se voi state usando l'assemblatore LINEA PER LINEA della M/NM, questi 
simboli sono predefiniti. Voi potete riferirvi a questi registri con i loro numeri 
(0, 1, 2, 33,...14, 15), se per voi e' piu' comodo, 


Mentre i registri sono speciali nei loro usi e funzioni, la loro composizione e' 
identica ad altre aree di memoria. Ogni registro e' una serie di 16 bits il cui stato 
ON/OFF rappresenta alcuni valori nel formato binario. La notazione Hex per i 
contenuti di un registro e’ data con quattro cifre. (16 bits, una cifra Hex per 4 
bits). Esenmpio;)0020,. 


Oltre ai registri di uso generale WORKSPACE, vi sono TRE REGISTRI HARDWARE usati 
dal computer per il computer stesso e il programma mentre esso sta girando. Questi 
registri santengono le indicazioni di indirizzi di subroutine s, dati, o altre risorse 
necessarie al vostro prograama, la posizione della prossima istruzione da eseguire, lo 
stato risultante dell'ultima istruzione eseguita, e l'indirizzo iniziale dei registri 
generali WORKSPACE. I valori contenuti in questi registri hardware saranno importanti 
per voi quando farete i vostri programmi ASSEMBLY. 


Il REGISTRO del CONTATORE DI PROGRAMMA (PC= Progran Counter) mantiene 
l'indicazione di un set di istruzioni. I valori di questo registro sono usati in 
unione con altri indirizzi dati per localizzare o "PUNTARE” la prossima istruzione del 
vostro programma. Quando il vostro programma sta girando, tutte le informazioni 
contenuta in esso sono aemorizzate. L'indirizzo di aemorizzazione che contiene il 
codice binario che rappresenta ogni istruzione del programma, viene gestito da questo 
registro. Cone le istruzioni del programma sono eseguite, questo registro viene 
incrementato puntando all'indirizzo della prossima istruzione logica. 
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COUNTER REGISTER (PC) 


HARDWARE PROGRAM INSTRUCTION SET 
REGISTERS RESIDING IN MEMORY 


TMS9900 MEMORY 

INSTRUCTION 1 
INSTRUCTION 2 
\__>| INSTRUCTION 3 
INSTRUCTION 4 


=—-- PROGRAM 


INSTRUCTION 5 


INSTRUCTION 6 


En ceo eee eo «» 0 ero re e è» ce ac» e ue Go 
«2 cre (oe «2 — =» stò no ne 0 ne ce dan neo eee eo e 
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Il REGISTRO PUNTATORE del WORKSPACE (WP= Workspace Pointer), contiene 
l'indirizzo, puntando all'indirizzo iniziale dei 16 registri generali del workspace. 
Molti gruppi di registri workspace possono essere definiti, e ogni gruppo puo' essere 
accessibile dalla manipolazione del programea degli indirizzi contenuti in questi 
registri. Questo puo’ essere utile specialmente quando sottoprogrammi sono chiamati 
dal vostro programma, che necessita dei suoi propri registri. 


WORKSPACE POINTER REGISTER (WP) 


HARDWARE PROGRAM INSTRUCTION SET 
REGISTERS AND WORKSPACE REGISTERS 
TMS9900 MEMORY 

I 

I 
[| LI 
I P.C. 11 
| I PROGRAM 

Î 

I 
W.P.I N 

| I \ > 


WORKSPACE "A" 


RO Rl R2 R3 
I ST. | 
R4 RS R6 R7 


R8 R9 RI10 Rll 
R12 R13 R14 R15 


WORKSPACE "B" 
RO Rl R2 R3 
R4 R5 R6 R?7 


R8 R9 R10 da 


R12 R13 R24 R15Î 
| 
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Il REGISTRO di STATO (ST= Status Register), registra lo stato dell'ultima 


istruzione esequita. I bit individuali sono fissati (1), o azzerrati (0), per 
indicare in certe condizioni come viene eseguita ogni istruzione. Il vostro codice 
del prograama si riferira’ a questo registro, sia direttamente, che indirettamente, 
molto spesso. Supponete di voler confrontare il valore X ed il valore Y. 


Immediatamente dopo che il conputer ha eseguito l'istruzione di confronto, il registro 
di stato indichera' dallo stato dei suoi bit, alcuni relazioni: 


REGISTRO di STATO 


POSIZIONE SIGNIFICATO 
BIT SE FISSATO A_ "1" 


0 Logicamente maggiore di... 

1 Aritmeticamente maggiore di... 
2 Uguaglianza 

3 Riporto 

4 Traboccamento (Owerflov) 

Ò Parita' dispari 


6 Operazione estesa 
7 - il Non usati 
12- 15 Maschera d’interruzione 


Il registro di stato puo' peraettervi di conoscere se due valori sono uqQuali, o 
dare evidenza a molte altre condizioni.Le operazioni aritmetichetrattano. 


Varie istruzioni disponibili per voi nel linguaggio ASSEMBLY, vi permetteranno di 
istruire il computer nel modo in cui desiderate che i contenuti di un byte vengano 
valutati. L'uso di questo registro verra' ripreso nei capitoli che trattano questo 
codice. 


Alcune istruzioni nel linguaggio ASSEMBLY si applicano solo ai registri, o sono 
richieste per coinvolgere almeno un registro. Il trasferimento dei dati, verso e dai 
sottoprogramni speciali, e' effettuato attraverso certi registri, cone e' il moviaento 
dei dati verso e da speciali aree del computer. Calcoli di indirizzi speciali e 
indici, sono possibili con i registri. 

I tre registri hardware (PC, WP, ST), e i 16 registri generali del workspace 
eseguono la maggioranza dei calcoli numerici, e assistono in quasi tutte le altre fasi 
della gestione e manipolazione dei dati. 

Parecchi fabbricanti di computers, e di linguaggi ASSEMBLY, offrono un nuaero 
differente di registri di lavoro (Workspace). Alcuni ne hanno solo 3, altri 8, o 16, 
o 32. Voi non avrete aai bisogno di scrivere programmi che utilizzino tutti i 16 
registri del TMS9900, aa il potenziale esiste. I registri sono un componente del 
microprocessore, e sono progettati nel set di istruzioni del processore. Per lui e' 
molto piu' veloce ed efficente operare sui suoi registri, che usare un'’indirizzo in 
memoria piu' distante. 
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MANUALE DI RIFERIMENTO E/A 

I seguenti riferimenti vi forniranno altre informazioni sui REGISTRI, 
Dalla sezione 3-1 pag. 39 alla sezione 3-1-3 pag. 40. 

LEGGERE QUESTI TERMINI SUL GLOSSARIO. 


BIT Aritmeticamente maggiore di... 
BIT di riporto (Carry) 

BIT di uguaglianza 

BIT logicamente maggiore di... 

BIT di parita' dispari 

BIT di traboccamento (Owerflow) 
Registro di contatore programma (PC) 
Registro 

Registro di stato (ST) 

Workspace 

Registro puntatore del Workspace (WP), 


IMPORTANTE 
Prima di procedere alla prossima sezione di questo libro, vai all’E/A, alla fine 


del capitolo cinque. Leggi inoltre le pagine indicate sopra, e ìi termini del 
glossario. Poi rileggi il capitolo, e poi ancora iì manuale E/A, se necessario. 
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CAPITOLO OUINTO 
CODIFICAZIONE 


Per aettere in pratica la teoria studiata fin'ora, voi dovrete imparare a 
codificare un programma in ASSEMBLY. Ma per prima cosa, prendete un po' di tempo per 
leggere il manuale di riferimento dell’'E/A nei punti indicati “alla fine di questo 
capitolo. Quando avrete fatto cio', osservate questo semplice programma in TI BASIC. 
Esaminate ogni istruzione ricordando quello che e' stato discusso nelle sezioni 
precedenti. 


10 CALL CLEAR 

20 AMTX=10 

30 AMTY=35 

40 AMTY=AMTX+AMTY 
50 PRINT AMTY 

60 END 


DISCUSSIONE DELLE VARIE ISTRUZIONI. 


10 CALL CLEAR. Questa istruzione pulira' lo schermo da qualsiasi carattere in 
quel momento visualizzato. Il) programaa in TI BASIC e' "chiamato" da un 
sottoprogramma residente nel TI BASIC con il nome "CLEAR". Cuesta routine fara’ tutto 
quello che e' necessario per pulire lo schermo, e poi ritornare il controllo alla 
prossima istruzione, cioe’ la linea... 


20 AMTX=10. Che riserva uno spazio di memoria assegnato all'etichetta "AMTX". 
Poi inizializza AMTX con il valore aritmetico di 10. 


30 AMTY=33. Mette da parte un altro spazio di memoria. Da’ a questo spazio il 
nome ."&MTY".,, e inizjalizza AMY gon il valore aritmetico di 33. 


40 AMTY=AMTX+AMTY. Addiziona il valore dell'indirizzo AMTX a quello di AMTY, e 
nette il totale nell'’indirizzo di AMTY. 


50 PRINT AMTY. Visualizza il valore memorizzato all'indirizzo "AMTY",con i 
simboli ASCII. La posizione sullo schermo dove verra’ visualizzato questo risultato, 
e' gia’ stata predeterminata dal TI BASIC come l'angolo inferiore sinistro. 
(Posizione di DEFAULT) 


60 END. Ritorna il controllo del computer al sistema operativo. 


Come voi potete vedere, ci sono molte cose che il computer deve fare per esequire 
ogni istruzione in TI BASIC. Pochi dettagli di questi compiti vengono visti da chi 
opera. L'interprete BASIC, ed il resto del “ Gruppo di supporto" si prendono cura di 
tutto questo. In un progranmna ASSEMBLY, voi dovrete essere gaolto piu' precisi 
nell'istruire il computer sui suoi incarichi, e su cone esequirli. 


Provate a codificare questo programma ASSEMBLY, per far eseguire la stessa cosa 
del programma BASIC di cui sopra. Ogni istruzione ASSEMBLY e' costituita da TRE parti 
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piu’ importanti, chiamati CAMPI, cioce': Un’ “ETICHETTA”, un " CODICE OPERATIVO *® 
(OP-CODE), o istruzione, e UNO o DUE OPERANDI. 
Ricordate l'esempio precedente di istruzione ASSEMBLY ?: 


SCRTAB EQU >}0000 


SCRTAB E° L'ETICHETTA. L'etichetta parte dalla prima posizione a sinistra della 
linea, e NON puo' essere lunga piu' di SEI caratteri (due con l”assemblatore LINEA per 
LINEA), e il primo carattere DEVE essere alfabetico. 

L'etichetta e' un'opzione e non e' sempre necessaria, Il codice operativo 
(OP-CODE) e’ separato dall'etichetta da almeno uno spazio. L'’OP-CODE e’ l’attuale 
istruzione del programma. ll) caapo operando e' separato a sua volta dall’OP-CODE di 
almeno uno spazio. Ci potranno essere, come gia' detto, UNO o DUE operandi. Se sono 
due, essi dovranno essere separati da una virgola. 

Il campo operando identifica il registro o un'altro indirizzo su cui l'istruzione 
(OP-CODE) sta operando. 

Quando sono necessari dei commenti, essi dovranno iniziare almeno uno spazio a 
destra dopo l’ultimo operando. Iniziando una nuova linea con un’asterisco (#), tutta 
la linea potra’ essere dedicata ai commenti. (L’asterisco ha la stessa funzione della 


REM in TI BASIC) 


Ecco qui” sotto un piccolo programma in ASSEMBLY del TMS9900, Scritto con il 
package dell’E/A. La "riga" numerata da Il fino a 50 indica le colonne, ed e’ inclusa 
qui*° per illustrare le posizioni relative di ogni campo. 





< Crue 


NOTA DEL CORRETTORE DELLA TRADUZIONE. 

Il listato del programma di cui sopra viene stampato a parte,;,ed allegato, in 
maniera da poterlo avere a portata di mano quando si controlla la spiegazione del 
programma stesso, cio' evita noiosi ritorni avanti e indietro con le pagine per 
controllare listato e spiegazioni. 





Non vi allarmate dell'alto nunero di istruzioni. I linguaggi ASSEMBLY sono 
sempre piu’ "Verbosi" dei linguaggi ad alto livello, come il BASIC. Ogni linea sara' 
analizzata e spiegata con molti utili comandi lungo la via. Alcune istruzioni in un 
programma in linguaggio ASSEMBLY, sono richieste di ingresso, e mostrano prograama 
dopo programma. 

Una volta che avrete scritto diversi prograagi in ASSEMBLY, esse diventeranno 
superflue. Come voi imparerete a progettare le vostre subroutines, esse potranno 
essere usate in qualsiasi altro programma, senza doverle rifare ogni volta. 
Nonostante la loro apparente (?) conplessita', tutte le operazioni, sono, ma con 
variazioni costanti, sul principio dei BITs e BYTEs, INDIRIZZAMENTI, REGISTRI, 
ARITMETICA BINARIA, e così via. (E non mi sembra poco...N.d.T.) 


Il programma e'* stato scritto in aaniera semplice, per dimostrare le funzioni 
specifiche con cui siete faniliari. Lo stesso prograama potrebbe essere scritto in 


manìera piu' breve e “scorrevole”, aa, poi a noi interessa un prograama per fare 10+33 2! 


Ecco qui' la spiegazione di ogni linea ASSEMBLY, 
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LINEA 01 DEF START 


DEFine, (DEFinisci) e' una DIRETTIVA ASSEMBLER. Una DIRETTIVA, e* una istruzione 
dell ''ASSEMBLER, che e' necessaria per il particolare ASSEMBLY del programma. Non c'e' 
nessun contrasto con l'esecuzione logica del programma. La DIRETTIVA DEF ha l’effetto 
di mettere il nome dato al programma (“START"), dentro un’area del computer conosciuta 
cone TAVOLA REF/DEF. Qui' vengono conservati i nomi di tutti i prograaai che sono 
correntemente in memoria. 

La direttiva DEF assicura che quando il vostro progranma e' caricato, il suo nome 
sara' aggiunto alla TAVOLA REF/DEF. Quando voi fate girare il prograama, questo e' il 
punto in cui il software RUN vede il suo none. 


START e" l'indirizzo simbolico del punto dove il vostro prograama inizia 
l'esecuzione. La direttiva DEF deve precedere l'etichetta che esso definisce. La 
pratica piu' comune e‘ senplicemente quella di metterla come prima istruzione del 
vostro programma . 

L'etichetta usata puo’ essere qualsiasi nome di etichetta valido, "START" e' il 
nome usato nel programma esenpio. 


LINEA 02 REF VSBW,VMBW 


La direttiva REF dice all’'assembler che voi intendete usare alcuni prograaai 
speciali residenti. Essa accede anche alla TAVOLA REF/DEF. Questa direttiva assicura 
che quando il vostro programma e' caricato, queste routines saranno disponibili per 
esso. VSBW sara’ reso uguale all'indirizzo della routine in VDP RAM per scrivere un 
singolo byte (Vdp Single Byte Write). VMBW sara' reso uguale all'indirizzo della 
routine in VDP RAM per scrivere piu' bytes (Vdp Multiple Byte Write). 

Queste routines sono usate per visualizzare sullo schermo grafici e caratteri. 
Esse sono proprio due membri del "gruppo di supporto” del linguaggio ASSEMBLY del 
TMS9900. 


LINEA 03 STATUS EQU>B37C 


Questa e° l’istruzione EQUate (eguaglia). Essa e' anche una direttiva. 
L'indirizzo e' quello dello “STATUS BYTE" (Byte di stato). Voi vi riferirete allo 
STATUS BYTE nel vostro prograama, riferendovi all'attuale indirizzo dell'etichetta 
siabolica “STATUS”. 

La direttiva EQUate, associa l'etichetta data con l'indirizzo >837C. L'indirizzo 
attuale unito al simbolo STATUS viene caricato durante il processo ASSEMBLY dentro 
un’area chiamata "TAVOLA dei SIMBOLI". L'assembler usa la TAVOLA dei SIMBOLI per 
trovare l’indirizzo proposto ogni volta che voi userete una etichetta simbolica cone 
STATUS. Voi dovete definire queste relazioni tra indirizzi di macchina e i loro nori 
simbolici, con la direttiva EQUate. 


04 SAVRTN DATA >0000 
05 AMTX DATA >000A 
06 AMTY DATA >0021 
07 DECTEN DATA >000A 


Queste linee usano le direttive DATA,. Questa direttiva e’ usata per 
inizializzare una WORD (parola) (16 bit=2bytes) di eemoria per qualche valore. Se una 


etichetta e’ inclusa, quest’ultima viene associata con l'indirizzo iniziale della 
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WORD. 


L'etichetta rappresenta un'indirizzo simbolico. L'operando contiene il valore 


della word che sta’ per essere fissata. Il valore puo' essere scritto in notazione 
decimale o esadecimale. Usando gli indirizzi simbolici ogni volta che e’ possibile, 
‘oi non dovrete tenere il conto dei valori dell'indirizzo. 

Le etichette che voi ideate avrano sempre un valore anemonico (aiutando la vostra 
aemoria). Il vostro programma sara’ piu' leggibile e comprensibile, se le etichette 


scelte saranno in relazione a quello che esse definiscono. 


AMTX DATA >000A Approssimativamente uguale a: AMTX=10 
AMTY DATA >0021 Approssimativanente uguale a: AMTY=33 


Una direttiva simile e’ la direttiva BYTE. L'istruzione MYBYTE BYTE >04, 
inizializza un byte (8 bits) di memoria. Gli effetti dei DATA e BYTE sono sinmilari, 
l'unica differenza e' il nuaero dei bits che sono inizializzati (8 o 16). L'assembler 
“Linea per linea” non riconosce la direttiva BYTE. 


09 PNTANS BSS 2 
10 WSPREG6 BSS >20 


Le linee 9 e 10 usano la direttiva "BSS", BLOCK STARTING with SIMBOL. Questo 
riserva i blocchi di aemoria senza qualsiasi inizializzazione. Queste aree saranno 
isate come workspace dal programma, e saranno parte del programma stesso. Nella linea 
?, sono stati riservati due bytes di memoria. Essi saranno attribuiti a “"PNTANS". La 
‘inea IO mette da parte 32 (>20) bytes chiamati "VSPREG". 

Il primo quarto di questo programma e' stato descritto, e nessuna istruzione e' 
ancora stata eseguita. Tutto quello che e' stato fatto finora puo' essere considerato 
ina preparazione. Quando codificate le istruzioni in TI BASIC, voi potete definire le 
‘ariabili nella stessa istruzione in cui sono usate per la prima volta. Non e' cosi 
nel linguaggio ASSEMBLY. Voi dovete definire tutte le etichette e le aree del 
sorkspace, prima che possiate riferirvi a loro nelle istruzioni del progranaa 


LINEA 11 START NOV RI1,QSAVRTN 


Qui’ c'e’ l'etichetta "START" che e' stata definita alla linea 1. Il primo scopo 
2° quello di salvare l'indirizzo di entrata del prograana. Il registro RI1 e' il 
registro che ha il compito di collegamento (Indirizzamento) generale del computer. 
2uando il vostro progranma ASSEMBLY inizia l'esecuzione, l'indirizzo al quale esso 
iovrebbe ritornare una volta fatto, e' in RII. Questo indirizzo e' essenziale per il 
zompletanento con successo del programma stesso. Voi dovrete salvare questo 
indirizzo, poiche’ RIl sara’ usato altrove nel prograama. La word di aemoria chiamata 
SAVTRN era stata messa da parte proprio per questo scopo. MOVe (Muovi) il valore in 
311 alla posizione di memorizzazione. 

L'indirizzo usato e’ un indirizzo simbolico, che e’ rappresentato in una 
istruzione MOVe dal simbolo $ “AT". L'operazione MOY copia una word (16 bits, 2 
nytes) di un registro, o altro indirizzo in memoria a un'altro indirizzo o registro. 
Il registro che contiene la word da copiare rimane invariato, mentre la posizione di 
nemorìzzazione ricevente diventa la sua copia. 


Supponiamo che RII contenga il valore indirizzo >}5258. Prima dell'istruzione 
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MOV: 

Rii )>3258 @ SAVRTN >}0000 
Dopo MOV, si ha: 

Riil >3238 @& SAVRTN >3238 


Notate che si e' usata una intera word (16 bits, 2 bytes). Supponiamo di dover 
spostare solo un bytes (8 bits) alla volta. Allora si dovra’ usare l'istruzione MOVB 
(Muovi un byte). In tutto il linguaggio ASSEMBLY del TMS9900 voi troverete istruzioni 
parallele, il cui indirizzo e' una word (16 bits) o un byte (8 bits) alla volta. Se 
voi usate l'istruzione byte con un registro, o un’ altro indirizzo word, l'istruzione 
usera' sempre il byte di sinistra, o byte piu' importante. Fer esempio: 


MOVB R3,R4 


Supponiamo che i contenuti dei registri usati, prima che l'istruzione sia 
eseguita, siano: 


R3 >104C R4 >OO11 
Allora si avra’, dopo MOVB: 
R3 >104C R4 DIGLI 


Notate come il byte destro (Byte aeno importante) rimanga inalterato, in ciascun 
registro, dalla istruzione MOVB. 


LINEA 12 LWPI WSPREG 


Ora voi LOAD WORKSPACE POINTER IMMEDIATE "LWPI"” (Carica immediatamente il 
p.ntatore dello spazio di lavoro). Voi avreta bisogno di stabilire un’area 
alternativa dei registri workspace per l’uso di routine speciali che sono necessarie. 
Esse possono avere il loro proprio gruppo di registri generali workspace. L'effetto 
di questa istruzione e' quello di puntare all'indirizzo del blocco di memoria che era 
definito alla linea 10. Questa e' una istruzione tipica di cui avrete bisogno in 
qualsiasi programma autonomo nel linguaggio ASSEMBLY del TM59900, 


LINEA 13 BLICLEAR 


Invece di chiamare una routine residente per pulire lo schermo, questo programma 
ha una sua routine codificata. L'istruzione “BRANCH and LINK" (BL), (Diramati e 
allacciati) e' all'incirca equivalente al GOSUR con RETURN del BASIC. Il controllo e’ 
passato da questo punto del programma, all'indirizzo CLEAR, e ancora una volta 
l'indirizzo di ritorno (indirizzo della prossima istruzione da eseguire) e' caricato 
nel registro RiIi. Quando codificate le istruzioni in BASIC, e dovete fare un GOTO ai 
numeri di linea, qualche volta risequenzando, potrebbe essere disastroso, se avete un 
numero di linea non ancora definito. Una delle finezze nell'uso di etichette, e che i 
numerì di linea non hanno effetto sul programma logico. 

CLEAR si riferisce all'indirizzo iniziale della subroutine CLEAR, e non importa 
Su quale linea e' il nuaero. RII ora contiene l'indirizzo della linea 14, che e' 
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quella dove voi dovete ritornare quando e* finita la routine CLEAR. 
L'esecuzione del progranma si trasferisce ora alla ... 


LINEA 34 CLEAR CLR RO 
LINEA 35 CLR RI 


"CLEAR" e l'etichetta alla quale voi avete istruito il computer per diramarsi. 
Il primo passo della routine CLEAR e‘ di fissare a zero tutti i bit dei registri 0 e 
i. l’istruzione CLEAR pulisce (cioe , mette a zero tutti i bit) una word di memoria, 
> un registro, alla volta. RO e RI adesso contengono: 


RO 20000 RI )0000 
LINEA 36 LDOP BLWP EVSBW 


Ora voi potete iniziare a "Giocherellare"” con il “Chip" del VDP (Video Display 
°rocessor). L'etichetta "LOOP" sara usata per costruire un semplice ciclo, eolto 
simile al ciclo FOR-NEXT del TI BASIC. Un ciclo (Loop) vi permette di eseguire 
in’istruzione molte volte. 


l'istruzione BLWP, e siaile ad "Diramati e allacciati* (Branch and Link), salvo 
:he questa volta voi volete che il registro del puntatore workspace (WP) punti ai 
“egistri workspace alternativi stabiliti alla linea Il. 

Questo richiede l'uso della VSBW e di altre routines residenti. BLWP vuol dire, 
îranch and Link Workspace Pointer (Diramati ed allacciati al puntatore morkspace). 
.-'indirizzo a cui l'esecuzione del programma si dirama, e° l'indirizzo della routine 
.n VDP RAM Single Byte Write "VSBW" (Scrivi un solo byte). Voi potete passare i 
‘alori a questo programma attraverso RO e RI 

In RO voi mettete l'indirizzo di destinazione in VDP RAM, nel quale volete 
icrivere, e mettete il byte dei dati nel byte sinistro (quello più importante) di RI. 


Generalmente RO e RI contengono tutti zeri. Ricordate che l'indirizzo zero in 
"DP RAM corrisponde alla riga 1 e colonna I dello schermo e RO in VDP RAM. La routine 
SBW ha scritto a questo indirizzo il byte sinistro, quello più importante,(8 bits) 
‘i RI (tutti zeri). Che cosa verra visualizzato a riga 1 e colonna 1 ? Niente Poi 
e voi aggiungete 1 al valore in RO e ripetete questo passo, l'indirizzo Ol in VDP RAM 
riga I e colonna 2) verra” pulito. Ci sono 768 posizioni dello schermo da pulire, e 
:iuesti indirizzi in VDP RAM vanno da 0 a 767 (in deciaale), o da >}0000 a >02FF. 

Così ciclo dopo ciclo, attraverso questi passi, finch® RO eù stato increaentato 
‘ino al valore di 767, e l’intero schermo e pulito. La prossima istruzione controlla 
\0 per questo vaore, 


LINEA 37 CI R0,767 
LINEA 38 JEQ CLEARX 


La linea 37 e un'istruzione di COMPARAZIONE IMMEDIATA (CI). Questa e‘ usata per 
‘onfrontare il valore di un registro con un valore conosciuto. Come risultato, i bits 
:el registro di stato, sono influiti, ed esaminati dalla prossima linea. In più, per 
‘onfrontare i registri per conoscerne i valori, ci sono istruzioni di comparazioni di 
‘ord per word, e confronti di byte per byte. 
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L'istruzione Jump if EQual (JE), (Salta se uguale) completa il confronto, 
dirigendo alcune azioni basate sul risultato. Questa istruzione controlla il bit di 
uguaglianza del registro di stato (ST) e, se fissato a uno, trasferisce il controllo 
all'etichetta CLEARX. 

Le istruzioni JUMP (salto) sono simili alle istruzioni G0T0 del BASIC. Gli 
indirizzi che esse usano devono stare dentro a 256 bytes dell'istruzione stessa. Se 
la differenza e' maggiore, il-messaggio d'errore "OUT OF RANGE" apparira”. durante 
l'assembly. Le «istruzioni JUMP non necessitano del prefisso "@" negli indirizzi 
simbolici. La prima volta che si entra in questo ciclo, la condizione di uguaglianza 
non sara" vera, e l'istruzione JEQ della linea 38 non avra effetto sull'esecuzione 
del programma. 


LINEA 39 INC RO 


INCrementare il valore di RO con il valore binario 1. Ricordate che questo 
valore sarà. usato come un indirizzo in VDP RAM. Ogni volta voi, attraverso questo, 
incresenterete quell’indirizzo di I. L'istruzione "INC®° incrementeraì. (aggiungendo un 
1 binario) il registro, o la word in memoria specificata nell'operando. C'e’. anche 
una istruzione "INCT® che incrementerà di 2. 


LINEA 40 JMP LOOP 
LINEA 41 CLEARX B #RiI 


La linea 40 e” un salto incondizionato all'etichetta LOOP, che completa il ciclo 
descritto sopra. Quando il valore 767 e stato raggiunto in RO, l'esecuzione del 
programma si trasferisce alla linea 41, CLEARX. Questa istruzione e’ una diramazione 
incondizionata (Branch) "B" (simile a GOTO del BASIC), all'indirizzo in RII. L'uso 
dell'asterisco (#) immediatamente prima del registro nominato, indica che il valore in 
Rit puo essere usato come un’indirizo. L'istruzione “BL" della linea 13, mette 
l'indirizzo della linea 14 in RI1, prima che la subroutine CLEAR venga eseguita. 
Adesso voi state istruendo il computer perché si diraai all'indirizzo in RIl, che è 
l'indirizzo della linea 14, 


LINEA 14 ADDUP A @AMTX,@AMTY 


L'etichetta ADDUP vi aiuta a ricordare e stato fatto. I contenuti della word 
(16 bits, 2 byte) all’indirizzo simbolico AMTX vengono aggiunti al valore 
all'indirizzo AMTY. Entrambi gli indirizzi richiedono il prefisso AT (€) per questo 
passo. 


Prima dell'indirizzo: GAMTX AMTY 
>000A )0021 

Addiziona >000A 

Dopo l’addizione >002B 


Adesso il risultato (>002B) e in AMTY. Ma il valore in AMTY e un valore 
binario, non nel codice ASCII corretto per visualizzare i caratteri "43" (equivalente 
dell’esadeci@male >002B) sullo schermo. Avrete quindi bisogno di visualizzare un }34 
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‘codice ASCII per il simbolo "4") in una posizione dello schermo, e un >33, (ASCII per 
'3") nella prossima posizione dello schermo, allo scopo di poter visualizzare il 
tumero "43". 

La prossima serie di istruzioni convertira il risultato nel formato 
‘isualizzabile. 


LINEA 15 MOV @GAMTY,RS 
LINEA 16 CLR RA4 


I registri 4 e S saranno usati per le operazioni aritaetiche necessarie, Il 
‘isultato (ancora in formato binario)" mosso nel RS, e R4 e” pulito. 


LINEA 17 DIV @DECTEN,RA4 

L'istruzione DIVide (Dividi) fa proprio questo; divide, DIV usa due registri 
successivi, in questo caso, R4 €é& RS. Voi avrete bisogno solo di specificare il 
“egistro R4 nel secondo operando, poiche? l’uso del prossimo registro disponibile è 
.aplicito. Il primo operando, DECTEN e il divisore. Questa istruzione divide il 
alore in RS dal valore in DECTEN, e mette il risultato in RA, e il resto eventuale in 
‘5. Dopo l'istruzione DIV: 

@DECTEN R4 RS 

}000A >)0000 }002B 
dopo la divisione 


>000A }0004 }0005 


Nel sistema decimale cio” sarebbe uguale a 43 diviso 10, cioè : 4 con il resto di 


LINEA 18 MASKUP A @HEX30,R5 


Questo addiziona il valore a HEX50 al valore in RS, e mette il risultato in RS. 
‘rima che la linea 18 venga eseguita, RS contiene >0003 (il binario 3). Il codice 
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:SCII per visualizzare "3" e" >33. La differenza tra questo e il risultato e* di >30 
.333 meno >03 = >30). Questo >30 0 "MASK" HEX30, deve essere addizionata al valore 
;jinario per renderlo uguale al proprio numero in codice ASCII. Prima dell'addizione: 
@HEX30 RS 
20030 20003 


Dopo l’addizione: 


RS ora contiene il codice ASCII di "3". Questa e" la prima cifra del vostro 
risultato visualizzabile, 


LINEA 19 MOV RS,@PNTANS 
Salvare questa parte del risultato nell’area che era stata riservata alla linea 
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9, PNTANS. Questa è una word che muove lé bits. Prima di MOV: 


RS 0033 @PNTANS >0000 
Dopo MOV 
RS >00335 EPNTANS >0033 


LINEA 20 MOV R4,R5 
LINEA 21 CLR RA 

LINEA 22 DIV EDECTEN,R4 
LINEA 23 A GHEXS50,RS 


Le linee da 20 a 25 ripetono il processo per la seconda cifra del risultato.. 
Quando 43 era diviso per 10 alla linea 17, il risultato 4 era messo in R4. Poi esso 
era nuovamente diviso per 10. Per fare questo è necessario metterlo in RS, e fissare 
a zero R4. Quattro diviso 10 da 0 come risultato con il resto di 4. Il resto (4) è 
messo in RS, a cui viene aggiunto un MASK di >30, In questo tipo di conversione 
logica, voi state operando su RS. RS contiene ora )}0034 (L’ASCII di "4"), 


LINEA 24 SLA RS,8 
LINEA 25 MOVB RS,EPNTANS 


Ora voi avete la parte “4” del "43" che desideravate visualizzare. Il prossimo 
passo da fare è quello di auoverlo al PNTANS, e avvicinarlo al "3". Poichè voi non 
volete distruggere il "3" che è ora in PNTANS, sarà aeglio auovere un byte invece che 
una parola. Ricordate che le istruzioni per i byte operano seapre sul byte sinistro 
(Quello più significativo). RS contiene >0034, il che vuol dire che il valore da 
muovere è nel byte "sbagliato". (Ci sono molti modi per fare tutto questo e il metodo 
usato quì è congegnato per illustrare l'uso dell'istruzione). Una maniera è aostrata 
alla linea 24. Questa è un'istruzione SHIFT (Sposta), ed è una delle cose speciali 
che solo i registri possono fare. La particolare istruzione usata è quella di "SHIFT 
LEFT ARITMETIC"” (Spostamento aritmetico sinistro) SLA. La linea 24 specifica che i 
bits nel registro 5 devono essere spostati di 8 posizioni a sinistra, e che la parte 
destra del registro deve essere riempito con zeri. Qui sotto sono indicati i 
contenuti di RS diviso nei suoi bits individuali, prima e dopo che l'istruzione SLA 
venga eseguita: 


28 


Prima di SLA: REG. S -Binario HEX 


BIT 0123456789ABCDEF 
VALORE 0000000000L110100 )0034 
(sesssa Sposta di 8 posizioni 

Dopo SLA 

001101000000000O0 >3400 
Prima di MOVR: RS )>3400 @PNTANS 0033 
Dopo MOVB RS 3400 @EPNTANS >3433 
LINEA 26 PUTUP LI R0,738 
LINEA 27 LI RI,PNTANS 
LINEA 28 LI R2,2 
LINEA 29 BLWP @VMBW 


Le linee da 26 a 29 usano le subroutine in VDP RAM (VMBW), per visualizzare il 
risultato finale. Le linee 26, 27, e 28 usano l'istruzione “LOAD IMMEDIATE" LI 
(Carica immediatamente). LI è usato per nmettere i valori nei registri. Come 
l'istruzione COMPARA IMMEDIATAMENTE (CI), LI è usato con valori specifici. Il primo 
operando indica un registro, il secondo, il valore. RO è caricato con l'indirizzo in 
YDP RAM della pRposizione desiderata sullo schermo. RI è caricato con l'indirizzo, 
(simbolico o reale), del dato da muovere ( non il dato stesso, ma l'indirizzo iniziale 
jove il dato è da cercare). In R2 è caricata la lunghezza, in bytes, del dato da 
nuovere. La diramazione alla subroutine mette }34353, trovato all'indirizzo PNTANS, in 
YDP RAM indirizzo 758 (Angolo basso a sinistra, dello scherno). La VDP RAM 
all'indirizzo 738, contiene }34 (codice ASCII per 4), e la VDP RAM all'indirizzo 7539 
contiene >35 (codice ASCII per 3). 


LINEA 30 EOJ MOV  E@SAVRTN,RII 


LINEA SI CLR @STATUS 
LINEA 32 DECT RII 
LINEA 53 RT 


Queste linee completano il prograama. Nella linea 42, la direttiva END, è una 
richiesta di ingreso, e informa l’'assembler che questa è la fine del codice sorgente. 
Se l'’etichetta "START" è stata inclusa come un'operando della direttiva END, (e voi 
state usando l’E/A): 


linea 42 END START 

Allora questo progranma comincerà a funzionare appena è stato caricato. 
Dipendendo dal tipo di applicazione per cui è stato scritto il programna, questo potrà 
o non potrà essere desiderato, 

Alla linea 30, l'indirizzo di ritorno che era stato salvato in E@SAVRTN, viene 


nosso (MOV) a RIl. La linea 31 “CLR" ( pulisce, cioè, mette a zero tutti i bits ) la 
word in aemoria all'indirizzo >)837C. >837C è l'indirizzo del byte di STATUS GPL 
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(Linguaggio di programmazione grafico). In effetti, pulendo questa locazione, 
‘0î state dicendo al sistema operativo del computer che ogni cosa è 0.K. 


La linea 32 DECrementa di due (DECT) Ril. "DEC" e “DECT®" sono l'opposto di "INC" 
a "INCT". Essi sottraggono rispettivamente 1 e 2. Diramandosi ad un'indirizzo che è 
aeno di 2 del punto di entrata dell'indirizzo, il computer “"congelerà" la risposta 
sisualizzata, finchè non viene premuto FCTN = (QUIT). 
Alterando l'indirizzo di ritorno in questa aaniera, non è proprio il sodo 
rigliore per finire il vostro programma. f questo punto, provate il programma senza 
‘istruzione DECT Rii della linea 31, e vedrete come è incredibilmente veloce il 
inguaggio ASSEMBLY del TMS9900. Lo schermo, in un batter d'occhio appena, 
isualizzerà il programma e terrinerà. Dbawiioadad anni 
La linea 33 usa l'istruzione "RT". Questa istruzione ha lo stesso effetto come B 
«RI. Esse sono intercambiabili. L'istruzione di ritorno "RT", è più facilmente 
‘omprensibile e leggibile. Essa è più amnemaonica (aiuta meglio la memoria) di B 3RII. 
:1 programma esegue un salto incondizionato all'indirizzo in Ril. Questo coapleta il 
:rogranna, e ritorna il controllo del computer al sistema operativo. 


Quì ora c'è il listato ASSEMBLY prodotto con l'E/A. Le opzioni usate sono: "R° 
etichetta per i registri generali workspace), "L* (che produce il listato), e "C° 
che produce il codice oggetto in formato compresso). 


NOTA DEL CORRETTORE: 
Il listato del programna è stampato a parte per una aigliore consultazione 
Fare riferimento ad esso nel leggere quello che segue 


La prima colonna di numeri sono i vostri numeri di linea. I valori nella seconda 
:olonna ( 0000, 0002, 0004, ecc. ©) rappresentano il contatore di locazione. Con 
. 'E/A, esso inizia da >0000 ed è incrementato all'indirizzo di ogni linea. Il 
.nntatore di locazione va da >000A a >000C alla linea 10, perchè la direttiva BSS 
ella linea 9 mette da parte 2 bytes di memoria che sono parte del progranaa. Così, 
Q00A + 2 = >000C. Notate che le prime tre direttive non influenzano il valore del 
.ontatore di locazione. I valori visti quì sono valori di spiazzanmento. Essi sono 
.ddizionati all'indirizzo iniziale, dove il codice è caricato, in ordine di indirizzo 
ii ogni linea o etichetta, nel progranna. 


La terza colonna di nuaeri sono la rappresentazione in Hex del codice @aacchina di 
igni indirizzo (Valore del contatore di locazione). Alla linea 5, locazione )}0002, 
oi vedrete il valore ?>000A (decimale 10), che è il valore a cui AMTX viene 
nizializzato. La linea 16, locazione }0042, mostra il valore }04C4. Questo è l'Hex 
.ar l'istruzione in linguaggio macchina, per CLR (resettare, o fissare a zero tutti i 
180). La lunghezza del vostro programma può essere determinata sottraendo il valore 
.niziale del contatore di locazione, dall'ultimo valore nello stesso contatore. In 
zuesto caso, >0090 - }0000 =)0090 , indicando che questo programma è lungo >90 bytes 
‘decimale 144). 
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isato 
ziasc 
zonta 


2semp 


Quì c’è la tavola dei siaboli costruiti dal programaa. Ogni simbolo che era 

accanto al suo indirizzo, è mostrato in ordine alfabetico. L'indirizzo dopo 
un simbolo, può essere l'indirizzo attuale (STATUS a >837C), o il valore. del 
tore di locazione, 


MANUALE DI RIFERIMENTO E/A 
I seguenti riferimenti vi forniranno altre informazioni sulla codificazione. 


Dalla sezione 3-3 pag. 46 alla sezione 3-9 pag. 55 
Dalla sezione 4-1 pag. 56 alla sezione 5-8 pag. 74 


INDIRIZZAMENTO 
Ci sono cinque modi di indirizzagento generali. Tre sono usati nel programma 


io. 

REGISTRO WORKSPACE DIRETTO MOV 11,6 
REGISTRO WORKSPACE INDIRETTO B «Ril 
MEMORIA SIMBOLICA A @AMTX,GAMTY 


Dalla sezione 14-1 pag. 208, alla sezione 14-1-1 pag..210 
Sezione 14-1-4 pag.212 

Dalla sezione 14-53 pag. 224, alla sezione 14-4-2 pag. 228 
Sezione 14-5-2 pag. 234 


DIRETTIVE 
Queste sono le direttive usate nel programma esenpio: 


AORG - Origine assoluta. Influisce sul contatore di locazione. 


B 
E 


SS - Riserva memoria 
QU Eguaglia. Associa un'etichetta con un'indirizzoa. 


BYTE - Inizializza 8 bits di memoria per alcuni valori. 


DATA - Inizializza 16 bits di aemoria per alcuni valori, 
TEXT - Inizializza la memoria usando un carattere stringa. 
DEF - Definisce. Crea le etichette che definiscono parte del vostro co 


dice oggetto, così che il programma sia utilizzabile per altro 
software e aggiunge le etichette nella tavola REF/DEF. 


REF - Riferiaenti esterni. Crea altre etichette di programma 


utilizzabili per il vostro progranna. 


END - Fine del codice sorgente. 


alla sezione 6-1 pag. 78, alla sezione 6-14-2 pag.102 


D 

ISTRUZIONI ARITMETICHE 

Queste operazioni aritmetiche sono usate, e dettagliate, nel programaa 

esempio: 

A - Addiziona Word. Addiziona gli operandi, e nette il risultato 
nel secondo operando 

INC - Incrementa il contenuto dell'operando, di li. 

INCT - Incrementa il contenuto dell’operando, di 2. 

DEC - Decrementa il contenuto dell'operando, di Il. 


Si 


DECT - Decrementa il contenuto dell’operando, di 2, 
DIV - Divide il primo operando dal secondo operando. 


Ogni istruzione aritmetica influisce il registro STATUS, in base ai 
risultati dell'operazione 


ISTRUZIONI PI SALTO E DIRAMAZIONE 
Cinque, delle molte specie di istruzioni di salto e diramazione usate 
nell'esempio, sono: 


B - Diramazione incondizionata, per diramarsi ad un'indirizzo specifico 

BL - Diramazione e allacciamento, e mette l'indirizzo di ritorno in RI 

BLWP- Diramati e carica il puntatore dello spazio di lavoro (Workspace) 
si dirama ad una routine, e fissa il registro WP per puntare a 
quelle routines dello spazio registri. 

JMP - Salto incondizionato ad un indirizzo. 

JEQ - Salta se uguale, Se il bit di uguaglianza del registro di stato 
(ST) è 1, allora salta all'indirizzo specificato. 


Dalla sezione 8-1 pag. 138, alla sezione 8-3 pag. 143 


ISTRUZIONI DI CONFRONTO 
Solo un tipo di istruzionei di confronto è usata nel programaa 
esempio. Comunque, esse operano tutte in modo simile. 


CI - Confronta immediatamente i contenuti del registro noainato 
(primo operando), per un valore specifico (secondo operando) 


Dalla sezione 10-1 pag. 161, alla sezione 10-5 pag. 168 
Sezione 10-99 pag. 172 


ISTRUZIONI PER CARICARE E MUOVERE 
Esistono 8 istruzioni di questo tipo, ma nel nostro programma ne 
abbiamo usato solo 4. 


LWPI- Carica immediatamente il puntatore workspace, necessario per 
stabilire registri alternativi di workspace. 

MOV - Muove una Word. Copia una Word (16 bits) in un’altra Word. 

MOVB- Muove un Byte. Copia un Byte (8 bits) in un'altro Byte. 

LI - Carica immediatamente, usato per aettere valori specifici in un 
registro. 


Queste istruzioni influiscono il registro di stato (ST), a seconda del 
valore all'indirizzo coinvolto. 


Sezione il-5 pag. 184 


ISTRUZIONI LOGICHE 
Una sola è usata nel programma esempio. 


CLR - Pulisce, fissa tutti i bit del registro o indirizzo nominato, a 
zero. 
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Dalla sezione 12-1 pag. 194, alla sezione 12-5 pag. 204 


ISTRUZIONI DI SPOSTAMENTO DEL REGISTRO WORKSPACE 
Nuovanente, solo un'istruzione è utilizzata, @a essa è analoga agli 
altri tipi di istruzioni di spostamento del registro. 


SLA - Spostamento aritaetico a sinistra. Sposta i bits del registro 
workspace nominato di un specificato numero di posizioni a 
sinistra, e riempie la parte destra con zeri, Tutte le 
istruzioni di spostamento influiscono il registro di stato (ST). 


Dalla sezione 13-1 pag. 206, alla sezione i3-2 pag. 207 


PSEUDO ISTRUZIONI 
Anche qui ne viene usata solo una. 


RT - Return. Lo stesso risultato di "B «Ri1" 


Sezione 19-2 pag. 307 


LEGGERE QUESTI TERMINI SUL GLOSSARIO 


Operatori aritmetici 

Campo commento 

Costante 

Context Switch (Commuttatore del contesto) 
CPU RAM 

Operando destinazione 

Direttive 

Espressioni 

Istruzioni immediate 

Indirizzamento di memoria indicizzato 
Istruzioni di salto 

Campo etichetta 

Contatore di locazione 

Codice anemonico 

Campo OP-CODE (codice operativo) 
Operando 

Campo operando 

Simboli predefiniti 

Pseudo istruzioni 

Siaboli 

Tavola dei simboli 

Indirizzi simbolici 

Indirizzamento simbolico della memoria 
VDP RAM 

Indirizzamento dei registri Workspace. 
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CAPITOLO SESTO 


ASSEMBLARE E FAR GIRARE UN FROGRAMMA. 
(con l’editor/assenbler) 


Buello che seque è una breve descrizione dei passi che dovrete fare per inserire, 
assemblare, salvare, e far girare il programma esempio del capitolo precedente. 

Leggere, nella documentazione che accompagna il package dell'’E/A, la parte 
‘iquardante l'EDITOR, per la preparazione dei programmi sorgente. Occorre un pò di 
empo per prendere confidenza con le capacità di EDITING che sono disponibili. Molte 
‘elle caratteristiche del programma EDITOR si possono applicare molto bene per la 
reparazione di testi e documenti, quanto per le istruzioni sorgenti ASSEMBLY. 

I dati presentati, presumono che voi abbiate un solo disk drive, ma se ne avete 
iù di unoy allora lasciate il dischetto con il programaa dell'E/A nel driver N*.1, e 
:alvate la vostra sorgente sul drive N*.2 o 3. 


Ottenete il titolo principale di schermo dell'’E/A, e con il dischetto del 
ottware nel driver I, selezionate l'opzione "EDIT" (N°.1). Questo vi presenta il 
enù dell'EDITOR, da cui scegliete l'opzione EDIT (N°.2). 

Il programma EDITOR si caricherà dal dischetto. Battete attentamente il 
rogramma di esempio, usando solo lettere MAIUSCOLE. Controllate quello che battete. 
l programma è stato assemblato e fatto girare con successo, sia con l'E/A che con la 
1. Se a voi non funziona è perchè avete fatto degli errori nel batterlo. 


Quando avete finito di inserire il codice sorgente, premete "ESCAPE" (FCTN 9) due 
olte, per ritornare al aenù dell'EDITOR. Poì inserite il discheto su cui volete 
alvare la vostra sorgente, nel disk driver scelto, e selezionate l'opzione "SAVE" 
4*.3), Il “PROMPT" (Richiamo, suggerimento) VARIABLE 80 FORMAT (Y/N)? apparirà. Se 
oi battete “Y" il formato sarà VARIABLE, mentre se battete "N", esso sarà FIXED. 

L'E/A tratta FILE di lunghezza sia VARIABLE, che FIXED. In questo esempio si e 
celto la lunghezza VARIABLE, per cui battete "Y". Poì inserite il nome con il quale 
olete chianare il programma sorgente. Per questo esempio battete "DSKI.SOURCE", e 
nfine premete ENTER. I contenuti del BUFFER testo (il progranma SOURCE che avete 
opena inserito) saranno salvati sul drive N*.1, in record di formato variabile lungo 
) byte, come “DSK1.SOURCE". 

Allora togliete il dischetto, e inserite quello con il programma Asseabler 
a11'E/A. Premete escape (FCTN 9) per visualizzare il menù dell’'E/A, e selezionate 
‘opzione “ASSEMBLE" (N°.2). 


A questo punto vi sarà chiesto se volete caricare 1'ASSEMBLER. Ciò è fatto per 
ermettervi di controllare ed assicurarvi che nel driver vi sia il dischetto giusto. 
e tutto è 0.K. rispondete "Y" al proanpt. 

Il prossimo prompt che vedrete vi chiederà il nome del file che contiene il 
ostro programma sorgente. Rimuovete il dischetto che contiene l'’assembler, ed 
nserite quello in cui avete salvato la sorgente. Battete “"DSKi.SOURCE". Apparirà un 
ltro prompt che vi chiederà il nome che vorrete dare al codice oggetto generato dal 
adice sorgente. In questo caso battete "DSK.OBJECT". Ancora un pronmpt per 
ichiedervi un name valido di un dispositivo per il listato dell'ASSEMBLY. 

Se non avete la stampante, voi potete salvare il listato su disco per rivederlo 
‘.uccessivamente con il programma EDITOR, oppure decidere di non avere un listato 
‘:e11'ASSEMBLY. Se invece avete una stampante, dovrete inserire i parametri che 
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descrivono l'interfaccia che state usando (Per Esempio: RS232.BA=1200, 
RS232/2.BA=9600.PA=N, PIO) 


Se decidete di non avere un listato stampato, o su disco, premete ENTER quando 
appare questo prompt. 

L'opzione per produrre o non produrre un listato sarà indicato dal prossimo 
prompt, il quale vi chiderà le opzioni desiderate per questo ASSEMBLY. L'opzione "R°” 
permette di riferirsi ai registri generali workspace nel programma come RÒ, RI, R2, 
R10, Ril, ..etc. L'opzione “"C" produrrà il codice ogetto in formato coapresso, il 
quale occupa meno memoria del codice oggetto non compresso. L'opzione “"L" è quella 
che vi permette di avere un listato dell’ASSEMBLY. Se voi non scegliete questa 
opzione, nessun listato sarà prodotto. "S"° è l'opzione che includerà una mappa della 
TAVOLA dei SIMBOLI, se avrete selezionato anche "L"., 

Per questo esercizio la giniaa opzione di cui avrete bisogno è "R". Scgliete le 
altre opzioni in base alla configurazione hardware che possedete . 


Esiste un’altra opzione supplesentare disponibile, che nan è docuaentata sul 
manuale E/A, ed è "°T". Questa stamperà le locazioni e il valore Hex di ogni byte di 
una stringa TEXT. Senza l'opzione "T" il listato ASSEMBLY staamperà solo l'indirizzo 
di inizio (valore del contatore di locazione), di una stringa TEXT, e il valore Hex 
solo del priao byte di quella stringa. 


"ASSEMBLER EXECUTING" (Esecuzione assembler) dovrebbe ora apparire, mentre 
l'assenbler elabora il vostro codice sorgente. Se ogni cosa è stata fatta bene, il 
processo ASSEMBLY dovrebbe terainare con “0000 ERRORS". Se vi sono degli errori, 
tornate indietro e riesaminate il codice sorgente che avete salvato come 
"DSK1.SOURCE". Per editare il codice sorgente, mettete il dischetto dell 'E/A nel disk 
driver N*.1. Ottenete il titolo di schermo EDITOR, e poi selezionate LOAD (N°.1). 
Dopo che l'’editor è stato caricato, vi sarà il prompt per il nome del file. A questo 
punto voi togliete il dischetto dell’E/A dal drive, e inserite quello contenente il 
vostro progranmna sorgente, e poi battete "DSK1.SOURCE". L'editor caricherà il 
programma. Selezionate infine l'opzione EDIT (N°.2) per rivedere ed editare il vostro 
programma sorgente. Quando avrete finito di correggere, risalvate il codice sorgente 
sotto lo stesso nome, e ripetete il processo ASSEMBLY. 


Una volta che avrete asseablato con successo il programma campione, pramete ENTER 
per ritornare allo schermo dell ’E/A, e selezionate l'opzione "LOAD and RUN" (N°.3), 
Il primo prompt vi chiederà il nome del file che contiene il vostro programma oggetto. 
Voi battete “"DSKI.OBJECT", ed il LOADER (Caricatore) lo caricherà dal dischetto nella 
memoria. Apparirà ora un'altro prompt di richiesta per il "FILE NAME” (None del 
file), Questo è perchè il loader dell'E/A vi permette di continuare a caricare 
programmi oggetto fino che la meaoria è piena. Siccome noi abbiano un solo prograama 
da caricare, a questo punto, premete ENTER. Il prossimo pronpt sarà per il "PROGRAM 
NAME" (None del programma). Il nome, ed il suo indirizzo del punto di entrata era 
DEFinito come "START". Battete START , e finalmente (speriamo...) il progranma 
dovrebbe girare. Se voi codificate l'ultima linea del programma come "END START", 
allora esso sarà eseguito imaediatamente appena caricato, senza che voi dobbiate dare 
l'indirizzo del punto di entrata. 


I numeri "43" appariranno nell'angolo inferiore sinistro dello scherao, Per 
uscire dal controllo del programma, premete “"QUIT" (FCTN =). Ritornerete così al 
titolo principale dello scherao. 


KE) 


Ricordate che è possibile aver fatto un errore inserendo il programma esempio, e 
terminare tuttavia con "0000 ERRORS" alla fine del processo ASSEMBLY. Quando il 
programma ASSEMBLY gira, esso è sotto il controllo del conputer, e può essere 
necessario spegnerlo e riaccenderlo, per riprendere il controllo di un programma 
ribelle, 


MANUALE DI RIFERIMENTO E/A 


I seguenti riferimenti vi forniranno altre informazioni su come assemblare e far 
girare i programmi. 


Dalla sezione l-1 pag.15, alla sezione 2-5 pag.38 

Dalla sezione 15-1 pag.235, alla sezione 15-1-1 pag.236 
Dalla sezione 15-5 pag.243, alla sezione 15-5-2 pag.245 
Dalla sezione 19-1 pag.305, alla sezione 19-2 pag.307 


GUARDA QUESTI TERMINI SUL GLOSSARIO 


Assembler 

Opzioni Assembler 

Modo comando 

Modo Edit 

Marcatore "Fine del file" 
Errore fatale (Errore grave) 
Lista del file 

Loader (Caricatore) 
Loading 

Errore non fatale 

Tasti speciali 

Simboli 

Tavola dei simboli 

Window (finestra) 


Sb 


CAPITOLO SETTIMO 
SCHERMO E VISUALIZZAZIONE DEI CARATTERI 


Una delle cose che potete fare nella maniera giusta, con un linguaggio cone il TI 
3ASIC, è di visualizzare numeri,lettere, ed altri sinboli sullo scherao, e controllare 
ia loro posizione e colore. Il programaa esenpio introduce due routines fondamentali 
sella VDP. I nuaeri "43", erano visualizzati nell'angolo inferiore sinistro dello 
schermo, ed essi apparivano come simboli neri su uno sfondo verde. Questi sono i 
zolori di DEFAULT dello schermo, ed il set di caratteri che sono esequiti quando 
. ASSEMBLY gira. Questo capitolo esaminerà più da vicino il linguaggio ASSEMBLY del 
‘MS9900 circa la visualizzazione sullo schermo. 


Il processo necessario per qenerare i segnali video che creano i siaboli, e i 
grafici, è trattato da un Microprocessore separato, il TMS9918A. 

Il processore centrale, come sapete è il TMS9900, ed è quello che tratta 
jirettamente con il linguaggio ASSEMBLY. Attualaente il nostro TI-99/4A, contiene 
Jarecchi microprocessori diversi, che lavorano di comune accordo, per permettere al 
-omputer di fare tutto quanto voi sapete....che è tanto. 


L'area della memoria indicata per il Video Display Processor (VDP), è necessita 
ii una speciale area separata, conosciuta come VDP Random Access Memory (RAM). 

Le istruzioni ASSEMBLY come MOVE, o ADD non lavoreranno su indirizzi dentro la 
#DP RAM. I dati devono essere manipolati dentro il dominio della CPU RAM, e scritti o 
latti dalla VDP RAM per mezzo di routine speciali, che permettono a questi due 
>rocessori di spartire i dati, e comunicare l'un l'altro. 11 primo programma esempio 
Aa introdotto due routines VDP molto utili, e cioè: VSBW (VDP Single Byte Write), e 
IMBW (VDP Multiple Byte Write), che ricopiano i dati del vostro programaa nella VDP 
ZAM. IT dati erano prima fissati dentro al prograama, poi mettendo certi valori 
richiesti nei propri registri, e diramati agli indirizzi delle routines, lo scherno 
ara pulito, e poi la somma di 10 più 33 era visualizzata. 

Questo modello di caricaaento dei registri chiave con certi valori di parametri, 
diramandosi a indirizzi speciali, ricorre durante tutte le varie routines VDP 

Per usare qualsiasi routine VDP nel vostro prograasa dovete includere una 
direttiva REF, con il nome simbolico di ogni routine che volete usare, 


Uno dei modi più facili per visualizzare titoli e messaggi, combina l'uso della 
direttiva TEXT e VMEW. Con l'E/A questo indirizzo simbolico della routine è 
aguagliato appunto a VMBW. Con la direttiva TEXT la memoria può essere inizializata 
facilmente con stringhe di caratteri leggibili. Il modo in cui la stringa appare nel 
programma è esattamente come essa apparirà quando sarà correttamente visualizzata. 
ecco quì una parte di programma che esegue questo: 


MSG1 TEXT ‘#* PROGRAMM NUMBER 2 #+° 


La stringa dei caratteri è racchiusa dai segni di virgolette semplici (‘’), ed 
esse non faranno parte di ciò che sarà visualizzato. Qualsiasi carattere può essere 
nella direttiva TEXT, escluso il siabolo della virgoletta singola. Essza può essere 
solo usata per delimitare i contenuti della stringa. Per visualizzare questo titolo 
del prograama, voi dovete dare alla VMBW tre tipi di informazioni: 
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1") L'indirizzo in VDP RAM in cui vorreste che questo aessaggio venga messo cioè 
scritto (La posizione sullo schermo) 


2*) L'indirizzo iniziale del messaggio. Dove trovare il messaggio. 
3*) Il numero dei byte da scrivere. La lunghezza del messaggio. 


In TI BASIC lo schermo può essere indirizzato come riga N, e colonna N. Ci sono 
24 righe e 32 colonne. Questa stessa configurazione dello schermo è definita nel 
linguaggio ASSEMBLY come una tavola di 768 Bytes. Questa è la TAVOLA IMMAGINE dello 
SCHERMO (TIS) nella VDF RAM. 

Ogni Byte di questa tavola rappresenta una posizione dello schermo. Gli 
indirizzi nella VDP RAM vanno da 0 a 767 decimale, e da >}0000 a >02FF Hex. Usate 
questa formula per determinare il giusto indirizzo in VDP RAM per un dato gruppo di 
valori dì righe o colonne. 


INDIRIZZO DECIMALE VDP RAM = ((RIGA - 1) # 32) + (COLONNA - 1) 
Per visualizzare il messaggio di cui sopra alla riga 10 e colonna 6: 


INDIRIZZO = (CI0 - 1) * 32) + (6 - 1) 
=(9a32) +5 

= 288 + 5 

= 293 


Per passare questa informazione al VMBW, metterla nel registro 0 con 
un'istruzione "LI" (carica immediatamente) 


LI R0,293 


Il prossimo tipo di informazione richiesto dal VMBW è l'indirizzo iniziale del 
nessaggio. L'etichetta "MSG1" era inclusa con la direttiva TEXT, e viene perciò 
aguagliata al valore dell'indirizzo iniziale del aessaggio. Ricordate che questo 
valore è L'INDIRIZZO del messaggio, e NON il dato stesso. La routine VMBW necessita 
Ji questa informazione nel registro i. Perciò, usando ancora l'istruzione "LI", 
avremo: 


LI RI,MSG1 

Ed alla fine,VMBWH necessita di sapere quanto è lungo il messaggio in bytes. 
Uccorre un byte per ogni carattere, del messaggio (spazi compresi). Siccome ci sono 
22 caratteri in MSGI, questo valore deve essere messo nel registro 2: 

LI R2,22 

Poichè il contatore di locazione (PC) avanza sempre ad un'indirizzo di word pari, 
à sempre una buona idea mettere da parte, memorizzando con una direttiva come TEXT, un 


totale pari di bytes. 


Per visualizzare il aessaggio, eseguire una BLWP all'indirizzo della routine 
VMBW: 


se 


BLWP @VMBW 


REF VMBW 
MSGI TEXT ‘#* PROGRAM NUMBER 2 #4° 
DISP LI R0,293 


LI Ri,MSGIl 
LI R2,22 
BLWP @VMBW 


Naturalmente la direttiva TEXT è soltanto uno dei aodi per costruire dati 
visualizabili. Voi potete anche usare i codici ASCII per lettere e numeri, e creare 
un programaa con stringhe alfanumeriche e numeri, proprio come il programma esempio 
fece con il risultato del suo problema di addizione. 


PNTANS BSS 2 
MOV RS,@PNTANS 
| MOVB RS, @PNTANS 
PUTUP LI R0,768 
LI =RI,PNTANS 
LI R2,2 
BLWP @VMBW 


La routine VSBW (VDP single byte write), scrive un solo byte alla volta. Poichè 
la lunghezza del dato da scrivere è sempre 1, il registro R2 non è necessario per la 
YSBW. Voi dovrete dare solo il corretto indirizzo alla VSEW, in RO, e il dato da 
scrivere nei primi 8 bits (bytes sinistro della word) del registro |. Questo è 
diverso dalla routine VMBW in cui il registro 1 conteneva l'indirizzo del dato. 


Supponete che al posto del titolo all'indirizzo MSGI, voi vogliate visualizzare 
il simbolo dell'asterisco (*), alla riga 10 e colonna 6. Il suo codice ASCII è 42 in 
decimale, 2A in Hex. Voi avete già calcolato il suo indirizzo in VDP RAM come 293, 
perciò: 


LI R0,738 
LI RI,>2A00 
BLWP @VSBH 


Una istruzione BASIC che dovrebbe esservi familiare è CALL SCREEN(n). 11 valore 
di "n" è un numero tra le 16, ed ogni numero rappresenta un colore diverso dello 
schermo. 

Nel linguaggio ASSEMBLY del TMS9900, è disponibile lo stesso set di colori, ma i 
loro valori vanno da 0 a 15 in decimale, )>0 a >F Hex. Il colore del bordo_ 


dello schermo è controllato dal registro 7 di sola scrittura della VDP RAM, LL accesso 
3 questo: “registro, e il controllo del colore del bordo ‘dello scherao è co oapiuto per 
mezzo della subroutine VDP Write To Register (Scrivi nel registro VDP), eqguagliata 


dall 'E/A a "VWTR". I colori, ed il loro valore in codice Hex, sono: 


TRASPARENTE 20 ROSSO >» 8 
NERO > 1 ROSSO CHIARO >9 
VERDE > 2 GIALLO SCURO >A 
VERDE CHIARO >3 GIALLO CHIARO >B 
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BLU SCURO >4 VERDE SCURO >C 


BLU CHIARO )5 MAGENTA >D 

ROSSO SCURO >6 GRIGIO )E 

CIANO >7 BIANCO )F 

Per fissare il colore del bordo dello schermo al MAGENTA, l'istruzione allora 
sarà: 

LI R0,)070D 


BLWP @VNHTR 


Il registro 0 contiene tutte le informazioni che servono al VWTR. Il byte 
sinistro (leggendo da sinistra a destra, la prima e la seconda cifra Hex, >07), del 
registro O, dice al VWTR in quale registro scrivere. In questo esempio, nel registro 
yDP 7. 

I registri VDP sono registri di UN SOLO BYTE (8 bit), a differenza dei registri 
generali workspace, che sono registri di Word, cioè 2 Bytes, o lé Bits. Il Byte 
Jestro, (cifra Hex >OD) contiene il valore del colore che volete, (in questo caso il 
nagenta). Di questi 8 Bits, i 4 bits meno importanti (cifra Hex )D) fissano il colore 
iel bordo dello schermo. I bits più importanti (cifra Hex )0) fissano il colore di 
FOREGROUND (Primo piano), quando il PROCESSORE VIDEO TMS 9918A è in MODO TESTO. 

Il MODO TESTO, è un'altra forma di visualizzazione disponibile con il processore 
video TMS?918A. Quando voi raggiungerete un buon livello di conpetenza con il 
linguaggio ASSEMBLY del TMS9900, e con l’uso del VDP, voi potrete provare altri nodi. 
Per ora il valore che metterete in questa posizione non ha nessuna importanza. Il 
modo di visualizzazione in cui il vostro computer opera aentre è in BASIC o EX.BASIC 
per la maggior parte di applicazioni, è il GRAPHICS MODE ( Modo grafico). 
Approfondire questo modo di visualizzazione prima di provare ad usarne altri. 


L'effetto di fissare il registro 7 della VDP RAM a )OD, è di creare una striscia 
di color magenta nella parte alta e bassa dello schermo. L'istruzione equivalente in 
BASIC, cioè CALL SCREEN (n), influisce non solo sul colore del bordo, ma su tutto il 
colore di BACKGROUND (colore di sfondo) di tutto lo schermo. In questa aaniera, non 
importa cos'è visualizzato sullo schermo, ci sarà un solo colore di sfondo, uniforme, 
per tutti i caratteri. 

I set di colori dei caratteri di foreground e background sul vostro conputer, 
zono controllati da un’area della VDP RAM conosciuta come TAVOLA DEI COLORI. 


Ogni entrata nella TAVOLA DEI COLORI è composta da un dato di un byte. Ogni byte 
controlla il colore di foreground e background di un gruppo di 8 caratteri. La Tavola 
dai Colori è rilocabile, cioè, con certe istruzioni del TMS9900 è possibile cambiare 
la locazione dentro il VDP RAM che la tavola occuperà. Canbiare le locazioni della 
Tavola dei colori, è necessario solo per altri modi di visualizzazione. Per adesso 
non rilocatela, ma usate il suo default, in VDP RAM, che inizia all'indirizzo )0380. 


40 


Per cambiare i colori di primo piano e di sfondo di un carattere particolare, 
deve essere determinato l'indirizzo corrispondente dentro la tavola dei colori, e un 
byte del dato deve essere messo in quell'indirizzo. Per simulare CALL SCREEN (n), è 
necessario cambiare il colore di sfondo, mentre si lascia il colore di primo piano al 
valore di default di >I (nero). Il valore per nero su aagenta dovrebbe essere dID. I 
quattro bits di sinistra del byte controllano il colore di foreground (>I = nero) 
mentre i quattro bits di destra controllano il colore di background (3D = magenta). 


Naturalmente questo dato deve essere anesso dentro l'indirizzo corretto della 
tavola dei colori, per produrre il risultato desiderato. Più sotto vi è una utile 
tabella che mostra in dettaglio la tavola dei colori. Gli indirizzi dati sono il 
valore di spiazzamento. Ogni valore della tabella deve essere aggiunto all'indirizzo 
iniziale della tavola dei colori in VDP RAM. Nel caso di questo esempio, operando in 
nodo grafico, e non avendo fatto niente per rilocare la tavola dei colori, l'indirizzo 


iniziale in VDP RAM di quest'ultima è )}OS5BO. 


TABELLA DI RIFERIMENTO DELLA TAVOLA DEI COLORI 


SPIAZZAMENTO DELLA CODICI DEI CARATTERI 
TAVOLA DEI COLORI INFLUITI 


>009 THROUGH >07 
> 08 >0F 
>19 >17 
> 18 > 1F 
>20 > 27 
> 28 > 2F 
>30 >37 
> 238 >3F 
>409 dD47 
>46 > 4F 


>S0 >57 
> 58 d SF 
>66 >67 
>68 > 6F 
>76 >77 
>78 >7F 
>80 >87 
>88 >8F 
>90 d>97 
>98 >9IF 


dAG DAT 
>AB8 DAF 
>BO >B7 


>B8 >BF 
>Co >C7 
>C8 »CF 
>DO >D7 
>D8 »DF 
DEG DE7 
dDE8 DEF 


>EFO DE7 
>E 8 DEF 


AL 





I codici dei caratteri per l'intera gamma dei caratteri possibili inizia a }00, e 
finisce a )FF. Riferendosi alla tabella appena riportata, la tavola dei colori 
indirizza il valore dello spiazzamento per il carattere >FF a )iF. Aggiungendo ognuno 
dei valori di spiazzamento all'indirizzo iniziale, che come già detto è >0380, si 
avrà: 


)0380+ )0380+ 
>0000= )001F= 
70380. 7039F” 


Questo dimostra che per influire sui colori di questa gaama di caratteri, un byte 
di dati del colore deve essere messo nel VDF RAM negli indirizzi da ?0380 a >039F. 
Poichè un solo byte di dati è richiesto per ogni indirizzo, verrà usata la routine 
YSBW. Le istruzioni per fare questo sono: 


LI R0,)053580 Carica RO con il primo.indirizzo in VDP RAN 

LI Ri,>)1D00 Mette il codice del colore nel byte sinistro di RI 
.TCOL BLHP @VSBW Scrive il byte sinistro di RI all'indirizzo in RÒ 

INC RÒ Aggiunge 1 all'indirizzo in RÒ 

CI RO, )039F Confronta il valore in RO con )}0359F 

JLE PUTCOL «+ + #52 più basso o equale, ripete il procedimento 


L'ultima istruzione usata era "JLE" JUMP if LOW or EQUAL (Salta se più basso o 
aguale). La precedente, "CI” COMPARE IMMEDIATE (Confronta immediatamente), controlla 
RO per l'ultimo valore dell'indirizzo che deve essere scritto. L'istruzione JLE 
completa il confronto, dirigendo il programma logico al ciclo PUTCOL, finchè il valore 
dell'indirizzo in RÒ è minore o uguale a )059F. 


I passi delineati sin qui per influire le entrate nella tavola dei colori, sono 
indicati per imitare il comando basic CALL SCREEN (n). Un altro comando basic è CALL 
COLOR (s.,f,b), dove "s" rappresenta il set di caratteri da visualizzare, "f" il colore 
di primo piano, e "b" il colore di sfondo. Il set può essere un numero da 1 a 14. In 
BASIC questi set di colori sono equivalenti allo spiazzamento della tavola dei colori, 
valori da >04 a )ll. Per specificare una combinazione di colori come "bianco su blu 
scuro", per l’asterisco (cod. car. = 42 dec. o >2A hex.}), dovrebbe essere usata 
l'istruzione BASIC: CALL COLOR(2,16,5). L'’asterisco fa parte del set di caratteri 
N*.2, in TI BASIC, i cui codici dei colori per il bianco e blu scuro sono 
rispettivamente 16 e 5. 


Per realizzare lo stesso risultato nel linguaggio ASSEMBLY del TMS9900, per prima 
cosa consultate la tabella di riferimento dei colori di più sopra, e poi cercate la 
gamma dei valori del codice dei caratteri a cui appartiene l'asterisco, Siccome il 
suo codice Hex ">2A" cade dentro la gamma dei valori da >28 a >2F, lo spiazzamento del 
valore sarà di >05. allora aggiungete questo valore di spiazzamento al valore 
iniziale della tavola dei colori, per determinare l'indirizzo corretto. ()0380 + )05 
= 20385). 


I valori dei colori, nell'ASSEMBLY del TMS9900 sono tutti UNO in aeno del loro 
valore in BASIC. Il bianco è IS dec. hex >F, il blu scuro è 4 dec. o >4 hex, Le 
istruzioni per fissare il colore dell'asterisco in bianco su sfondo blu scuro, allora 
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saranno: 


LI RO,>}0385 Indirizzo della tavola dei colori, per l'asterisco 
LI R1,>}F400 Valore dei colori, Bianco "F", e blu scuro "4" 
BLWP  @VSBW Scrive un byte di dati 


Nessun ciclo di programma è coinvolto, perchè quest’'esempio influisce solo sui 
colori di primo piano e sfondo di un set di caratteri, Notare dalla tavola di 
riferimento dei colori, che vi sono entrate per codici inferiori e maggiori della 
gamma dei caratteri ASCII (da 30 a 126 dec. da DIE a )7E hex). Questi valori non 
sono definiti come caratteri visualizzabili. Alcuni rappresentano codici ASCII di 
controllo, che regolano le comunicazioni tra computer. Per mezzo del linquaggio 
ASSEMBLY del TMS9900, voi potete far uso di tutti questi valori dei caratteri in varie 
maniere. 


Per prima cosa richiamate il programma esempio, e la routine CLEAR. Il aetodo 
standard per pulire lo scherao, è di riempirlo interanente di spazi (cod. dec.32, >20 
hex). Ma la routine CLEAR del programma d'esempio scriveva il codice del carattere 
>)00 sullo schermo...e questo è perchè il suo codice non è definito cone siabolo 
visualizzabile, per cui il suo effetto è Î0 stesso come se avessimo usato il codice 
del carattere spazio. 


Un altro modo di usare questi codici extra dei caratteri è per i grafici a 
colori. Ricordate, dal TI BASIC, che se i colori di foreground e background di un 
carattere sono fissati allo stesso colore, ogniqualvolta che il carattere è 
visualizzato, apparirà un unico blocco di colore. Un sistema per applicare questo, 
potrebbe essere la creazione di un bordo colorato attorno allo schermo. Ogni riga 
dello schermo contiene 32 colonne. Fer creare questo bordo usate le colonne 1,2 e 
31,372 di ogni riga. Fissare i caratteri usati per riempire queste colonne allo stesso 
colore del bordo della parte alta e bassa dello schermo. Per fare in maniera da poter 
ancora visualizzare e usare il set di caratteri standard ASCII, usate dei caratteri 
che che sono fuori dalla gaana di quelli visualizzabili, o che sono poco usati. 


Qui sotto vi sono le istruzioni per l'ASSEMBLY del TMS9900. Notate che la 
direttiva "DATA" può essere usata per inizializzare più di una parola alla volta. 


BORDER DATA >8080,>2020,)2020,)2020 
DATA >2020,>2020,)2020,}2020 
DATA >2020,>2020,)2020,)2020 
DATA >2020,>2020,)2020,)8080 


*Definisce 32 caratteri da usare per riempire 

*ogni riga dello schermo. I caratteri che occupano 

*le colonne 1,2 e 31,32 sono maggiori di qualsiasi 
*codice ASCII, e caratteri nelle rimanenti colonne sono 
#SFAZI (dec.32 >20hex). 


LI RO,20706 Fissa la parte alta e bassa al blu scuro. 

BLWHP @VWTR 

LI RO,?)0390 Fissa il colore del carattere )80 al rosso 
SCUrO SU rosso SCUro. 

LI R1,)6600 
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BLWP @VSEW 
LI RO,>03583 Fissa la gamma dei caratteri ASCII come nero su 
bianco. Il carattere spazio (>20) apparirà 


bianco. 
LI RI,>1F00 
CLOOP = BLWP @VSBWH 
CI R0,)038F 
JEG BPUT 
INC RO 
JMP_CLOOP 
BPUT LI RO,0 Riempie lo schermo con il pattern del bordo. 
LI RI,BORDER 
LI R2,32 
BLOOP  BLWP &VMBW 
CI R0,756 
JEQ EXIT 
AI RO,32 Addiziona immediatamente 32 a RO, per 


indirizzare la nuova riga. 
EXIT o ces oa e 0 ce 60€ 


(resto del prograana) 


BIANCO 
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I pattern usati per generare i caratteri, sono controllati da un'altra tavola 
della VDP RAM, chiamata TAVOLA DESCRITTRICE DEI PATTERN, <TDP) ed è anch'essa 
rilocabile. Il default dell'indirizzo iniziale in VDP RAN della Tavola descrittrice 
dei pattern, è >}0800. Ogni entrata della tavola occupa 8 bytes. Cambiando i valori 
memorizzati nella suddetta tavola, potrete così crearvi i vostri grafici o simboli 
personali. Potrete ridefinire il set di caratteri ASCII, o-usare qualsiasi altro 
carattere disponibile. Per una completa spiegazione su come creare i pattern, 
riferitevi ai manuali TI BASIC, o EX/BASIC, sottoprogramai CALL CHAR. 

L'accesso alla Tavola Descrittrice dei Pattern, è molto siaile a quello della 
Tavola dei Colori. Per ridefinire un carattere, o creare un grafico, i dati che 
iescrivono il! pattern devono essere messi nel corrispondente indirizzo nella "TDP”, 
con il codice del carattere usato. Per aiutarvi a partire, vi è qui una lista 
parziale di spiazzamento dei valori della “TDP", ed i loro rispettivi codici dei 
caratteri. Con un piccolo calcolo voi sarete in grado di determinare l'indirizzo che 
volete. 


TABELLA DI RIFERIMENTO DELLA TAVOLA DESCRITTRICE DEI PATTERN 


DESCRITTORE PATTERN CARATTERE 

SPIAZZAMENTO TAVOLA CODICE INFLUITO 
)000 >00 
7008 )01 
)OFO DIE 
>100 )20 
>108 >21 
>110 ) 22 
)150 >2A 
>158 >2B 
>160 >2C 
>168 >2D 


Se voi msoltiplicate il valore del codice del carattere per 8, voi troverete il 
valore di spiazzamento nella "TDP" per quel carattere. Questo valore deve essere 
aggiunto all'indirizzo iniziale in VDP RAM per la “TDP". A aeno che voi rilochiate la 
"tavola" per mezzo di istruzioni speciali, essa inizierà a }0800 Hex, 2048 dec. Per 
creare un nuovo simbolo del cursore, per esempio, voi dovrete per prima cosa 
moltiplicare il codice del carattere del cursore che volete ridefinire, per 8: 


HEX DECIMALE 
CURSORE = DLE # 30 # 
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)8 = gG= 


>FÒ 240 


Poi aggiungere questo risultato all'indirizzo iniziale in VDP RAM. 


Indirizzo iniziàle PDT )0800 + 2048 + 
Valore di spiazzamento )00F0 = 240 = 
Indirizzo desiderato )08F0 2288 


Adesso voi sapete che l'indirizzo di entrata della TDP, per il 
pattern del nuovo cursore è >0B8F0 Hex, Dec. 2288. Le istruzioni 
dell 'ASSEMBLY TMS9900 per cambiare il pattern del cursore, sono: 


CURPAT DATA >007E,)4242,)34242,>7E00 


*#Definisce 8 nuovi bytes di dati 
*#per descrivere il nuovo pattern. 


LI RO,>0BFO Carica l'indirizzo VDP RAM in RO. 
LI RiI,CURPAT Carica l'indirizzo dei dati in RI 
LI RZ7,8 Carica la lunghezza dei dati in R2 
BLHP &VMBW 


Adesso, il simbolo del cursore è visualizzato con un set di 
istruzioni simile a questo: 


LI R0,293 
LI RI,}1E00 
BLWP @VSBW 


Il pattern che è stato definito, sarà visualizzato al posto del simbolo standard 
del cursore. Notate che il codice del carattere per il cursore >IE, è ancora usato. 
Il computer prende il codice del carattere da voi specificato, guarda nella tavola dei 
zolori per, il corretto colore di primo piano e sfondo, poi Qquarda nella PDT, per il 
Jattern da visualizzare, ed infine visualizza la giusta combinazione pattern/colore 
all'indirizzo specificato, sullo schermo. 


Visualizzare lo schermo ed i caratteri, creati per mezzo del linguaggio ASSEMBLY 
del TMS9900, non è difficile, una volta che siete padroni degli schemi fondamentali di 
questo capitolo. La sorprendente velocità del linguaggio ASSEMBLY diventa evidente 
quando è usata con le applicazioni del VDP. 

I cambi dello schermo visualizzato avvengono quasi istantaneamente. Maggiori 
capacità grafiche diventano accessibili per mezzo del TMS9900, che sono anche 
zossibili in BASIC. 

Ecco quì sotto un completo prograama in linguaggio ASSEMBLY del TMS9900, che vi 
iimostrerà alcuni dei principi inclusi in questo capitolo. 


DEF START 
REF VWTR,VSBW,VMBW 
WR BS5  >20 
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RETURN 
STATUS 
BORDER 


MSGI 
START 


CLOOP 


BPUT 


BLOOP 


EXIT 


Seguire 
prograana, 
dal primo 
risultato. 


BSS 
EQU 
DATA 
DATA 
DATA 
DATA 
TEXT 
MOV 
LUPI 
LI 
BLWP 
LI 


LI 
BLWUP 
LI 


LI 
BLWF 
CI 
JEOQ 
INC 
JMP 
LI 
LI 
LI 
BLWP 
CI 
JEQ 
AI 
JMP 
LI 
LI 
LI 
BLUP 
CLR 
MOV 
DECT 
RT 
END 


le 


2 

>B37C 

)8080,>2020,)2020,)2020 

>)2020,}2020,)2020,)2020 

)2020,}2020,)2020,>2020 

>2020,}2020,)2020,>8080 

‘#*+ PROGRAM NUMBER 2 #+° 

Rit ,RETURN Salva l'indirizzo di ritorno 

WR Carica il puntatore Workspace 

R0,>30706 Fissa il colore del bordo come rosso scuro 

@VYUTR 

RO, 20590 Fissa il colore del carattere )80 cone 
rosso Scuro su rosso Scuro 

R1,)6600 

@evsBy 

RO,>583 Fissa la gamaa dei colori dei caratteri 
ASCII da visualizzare, come nero su bianco. 

Ri,>}1F00 

@VSBW 

RO, })038F 

BPUT 

RO 

CLOOP 

R0,0 Carica la TIS con il pattern del bordo 

R1, BORDER 

R2,32 

@VMBW 

R0,756 

EXIT 

R0,32 

BLOOP 

L0,293 Visualizza il titolo del programaa 

R1I,MSGI 

R2,22 

@VMBW 

@STATUS Pulisce il byte del GPL status 

@RETURN,RI1 Indirizzo di ritorno 

Ril Altera l'indirizzo di ritorno 
Ritorno 


istruzioni del capitolo 6 per assemblare e far girare questo 


Poichè questo programma altera l'indirizzo di ritorno, come è stato fatto 
programma di esempio, esso si congelerà, per peraettervi di osservare il 
Per uscire dal programaa premere FCTN= (QUIT). 


MANUALE DI RIFERIMENTO E/A 


I seguenti riferimenti vi forniranno altre inforaazioni sulla visuatizzazione 
dello scherao e dei caratteri. 
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Dalla sezione 16-1 pag. 246 alla sezione 16-1 pag. 248 
Dalla sezione 21-1 pag. 325 alla sezione 21-2-3 pag. 330 
Dalla sezione 21-7 pag. 342 alla sezione 21-7-1 pag. 342 
sezione 24-7 pag. 428 


GUARDA QUESTI TERMINI SUL GLOSSARIO 


Costanti caratteri 

Set caratteri 

Stringhe caratteri 

Tavola dei colori 

Caratteri non visualizzabili 
Utilità 

VDP RAM 
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CAPITOLO OTTAVO 
ELABORAZIONE DELL’'INGRESSO DA TASTIERA 


L'accettazione e l'elaborazione dei dati inseriti dall'utente, attraverso la 
tastiera, è sempre una funzione importante del programma. L'accettazione 
dell'ingresso da tastiera implica anche la migliore visualizzazione dello schermo. 
Tutte le volte che voi inserite un dato premendo i tasti, vi aspettate di vedere i 
caratteri che voi avete battuto, visualizzati sullo schermo così come sono stati 
inseriti. In più, inserendo i dati, vi state abituando ad usare le speciali 
combinazioni dei tasti funzione per controllare le operazioni del computer. 


Molti metodi per realizzare questo sono disponibili in TI BASIC. INPUT X è 
un'istruzione che può essere usata per inserire un valore numerico. CALL KEY(x,y;z) è 
un’altra istruzione che può rivelare specifici tasti premuti. Questi semplici comandi 
in TI BASIC, sono capaci di eseguire incarichi che sono molto più complessi di come 
appare dalla sintassi richiesta dal TI BASIC 


Il linguaggio ASSEMBLY del TMS9900 che vi avvicina a questi obbiettivi implica la 
lettura e scrittura in VDP RAM, e l’uso di una speciale routine chiamata KEYBOARD SCAN 
UTILITY (Utilità Scansione della Tastiera). Questa routine è accessibile includendo 
una direttiva REF KSCAN quando si programma con l'E/A, o E@Uagliando questa routine 
all'indirizzo >6020. Come la maggior parte delle routine precedentemente discusse, 
KSCAN deve usare l'istruzione BLWP per attivare l'utilità. 


Oltre alla routine stessa, vi sono anche alcuni indirizzi speciali che avrete 
bisogno di conoscere sopra l'uso effettivo di KSCAN. Il valore del byte all'indirizzo 
>B374 controlla quale dispositivo della tastiera deve essere esplorato. Un valore di 
)00 esplora l’intera tastiera. Un valore di >OI esplora la parte sinistra della 
tastiera, incluso il Joystik N°.1. 1 valori del Joystik sono messi agli indirizzi 
)B376 (valore Y), e >8377 (valore X). Un valore di >02 all'indirizzo >85374 esplora la 
parte destra della tastiera, ed il Joystik N°*.2. I valori del Joystik N*.2 sono messi 
agli stessi indirizzi del N*.1 (>8376,>B377). Il valore normale o di default a >E374 
è 00, (controlla cioè l'intera tastiera). Un altro indirizzo è)837C, già usato in 
precedenza, ed è l'indirizzo dello STATUS byte GPL. Ogni volta che un tasto è 
premuto, e che è diverso dal tasto premuto l'ultima volta che KSCAN è stata chiamata, 
il BIT 2 dello STATUS byte BPL viene fissato a 1. Il valore del tasto premuto è messo 
all'indirizzo 83575. Se nessun tasto era stato premuto, i'ndirizzo >8375 contiene 
)FF. 


In attesa che i dati vengano inseriti nel computer, voi vedrete il cursore sullo 
scherno che segna l’inizio del campo di input. Come il dato è inserito, il cursore si 
muove alla destra, e il dato stesso viene visualizzato dov'era il cursore, Per 
ultimo, se viene fatto uno sbaglio inserendo il dato, voi dovrete essere in grado di 
tornare indietro, e reinserire il dato stesso, finchè ENTER non è premuto. 


C'è qui una subroutine fondamentale per eseguire quanto sopra detto. Il suo nome 
è "CURSOR". Esso presume che la direttiva EQUate sia stata inclusa per KEYADR EQU 
>»B374, KEYVAL EGQU >8375, STATUS EQU >B37C, e che le direttive BYTE siano incluse per 
ENTER BYTE >0D, LEFTV BYTE >08, RITEV BYTE >09, ANYKEY BYTE >20. 
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SUBROUTINE 


INFUT: 


OUTPUT: 


01 


CURSOR 


SCAN 


ENTCHK 


CURPUT 


LEFT 


RITE 


RO 
RIO 


R9 
R7 


"CURSOR" 


= Indirizzo dì risposta dello schermo. 


Massima lunghezza della risposta. 


Ultimo valore del tasto preauto. 
Lunghezza attuale della risposta. 


(i dati della risposta iniziano a RO 
per una lunghezza di R7), 


CLR 


R9 
RIO,RI0 
SCAN 
@KEYADR 
R1,})LE00 
@VSBW 

RO, RB 
RB8,R10 
R8,R7 
ESTATUS 
EKSCAN. 
GANYKEY, @STATUS 
SCAN 
R10,RI10 
ENTCHK 


@ENTERV, EKEYVAL 
ENTER 

@ELEFTV, EKEYVAL 

LEFT 

@RITEV, @KEYVAL 


R7,RO 
@KEYVAL,RI 
@KEYVAL,R9 
@VSBW 

R7 

R7,R0 
R1,}1E00 
eVSBW 
ESCAN 
R7,R8 

SCAN 

R7,R0 
R1,)2000 
EVSBW 

R7 

CURPUT 
R7,ROI 
SCAN 
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43 MOV R7,R0 


44 LI = R1,)2000 
45 BLWF@VSBW 

46 INC R7 

47 JMP_ = CURPUT 
48 ENTER LI R1,)2000 
49 MOV R7,RO 

50 BLHP @VSBW 

SI S R8,K7 

52 RT 


Prima di analizzare questa subroutine, c'è quì spiegato come voi dovreste usarla 
nel vostro programma. Prima di eseguire una BL CURSOR, nmettete nel RO l'indirizzo 
iniziale dello schermo dove voi volete far apparire l’INPUT da tastiera. Nel RIO 
mettete la massima lunghezza del dato da essere accettato. Se voi volete simulare un 
"PRESS ANY KEY" = (premi qualsiasi tasto), mettete un valore di lunghezza 0 nel RIO. 
La routine CURSOR ritornerà al vostro programma appena un tasto qualsiasi viene 
premuto, senza accettare nessun dato, appunto. 

Molto spesso, quando voi volete che l'utente del computer risponda ad un PROMPT = 
(suggerimento), la risposta data ha il valore di una cifra. Un esempio di questo è 
quando l'utente deve rispondere "Y" o “N“, o scegliere un numero o una lettera da un 
"MENU". CURSOR mette sempre il valore dell'ultimo tasto premuto prima di premere 
ENTER, nel byte sinistro di R9. Fer la risposta di una cifra, il valore della 
risposta è disponibile in R9 dopo il ritorno dal CURSOR, senza qualsiasi movimento o 
altre manipolazioni. R7 conterrà la lunghezza attuale del dato che era stato 
inserito. L'attuale numero dei caratteri battuti possono o non possono essere gli 
stessi del massimo permesso. 


01 CURSOR CLR R9 


02 MOV RIO,RIO 
03 JEQ SCAN 

04 CLR EKEVADR 
05 LI RI,}1E00 
06 BLWP @VSEW 


La linea i del programma CURSOR, pulisce il registro 9. Le linee 2 e 3 
controllano RIO per un valore di 0. Se un registro, una parola, o un byte, è mosso a 
se stesso, ed il valore del numero è zero, allora il bit di equaglianza del registro 
di STATUS, viene fissato a 1. La linea 3 salta all'etichetta SCAN, se RIO è uquale a 
0. La linea 4 pulisce gli indirizzi >8374 & >8375. L'istruzione CLR pulisce (fissa a 
O tutti i bit) di una Word di memoria. É6li indirizzo simbolico KEYADR era equagliato 
(EQU) a >B8374. L'istruzione CLR, pulisce questo byte, ed anche il prossimo ()8575), 
che è l'indirizzo di KEYVAL. 

Con una istruzione, voi avete specificato che volete esplorare l’intera tastiera, 
e pulire qualsiasi valore precedentemente battuto. La linea S, carica RI con il 
codice del carattere del simbolo del cursore ()iE). Ed infine la linea è scrive il 
simbolo del cursore all'indirizzo di schermo da voi specificato in RÒ, prima di 
diramarvi a CURSOR. 


07 MOV = RO,R8 
08 A R8,R10 
09 MOV RB,R7 


Lp | 


10 SCAN CLR ESTATUS 


La linea 7 salva l'indirizzo iniziale del cursore in R8. La linea 8 aggiunge 
l'indirizzo iniziale di R8 alla lunghezza del valore in RI0, per determinare 
l'indirizzo @assimo del cursore. La linea 9 muove l'indirizzo iniziale del cursore in 
R7, che sarà usato come un accumulatore dei valori degli indirizzi del cursore. La 
linea 10 pulisce il GPL STATUS byte. Voi dovrete avere il byte di STATUS con tutti 
zeri, allo scopo di rilevare qualsiasi movimento dei tasti. 


ii BLHP = GKSCAN 

12 CB GANYKEY, @STATUS 
13 JNE = SCAN 

14 MOV RIO,RIO 

15 JNE = ENTCHK 

16 RTN 


La linea il chiama l'utilità di esplorazione della tastiera. La linea 12 usa 
l'istruzione CR per confrontare il valore del GFL STATUS byte con ?20. Questo è il 
valore che sarà presente nel GPL STATUS byte se un qualsiasi tasto è stato premuto. 
Alla linea 15, l'istruzione JNE (salta se non uguale) completa il confronto, 
ritornando all'etichetta SCAN se nessun tasto è stato premuto. La linea 14 controlla 
ancora RIO con lo zero , muovendo a se stesso, e se RIO non è uguale a zero, allora 
esso salta all'etichetta ENTCHK. Se invece RIO è uguale a zero, la linea i6é ritorna 
(B*R11) al progranma di chiamata. 


17 ENTCHK CB @ENTERV, @KEYVAL 
18 JEG = ENTER 

19 CB @LEFTV, @KEYVAL 
20 JER = LEFT 

21 CB @RITEV, &KEYVAL 
22 JEQ = RITE 

23 C R7,R10 

24 JEQ = SCAN 

25 MOV R7,R0 

26 MOVB = E@KEYVAL,RI 

27 MOVB = @KEYVAL,R9 

28 BLWP = @VSBW 

29 INC R7 


CURSOR salta alla linea 17 se qualche tasto è stato premuto e RIO non è uguale a 
zero. La prima cosa da fare è di determinare se qualche tasto speciale è stato 
premuto. Se l'utente hà premuto ENTER, allora esso ha finito di inserire dati. I} 
valore a >8375, quando il tasto ENTER è premuto, è di >}0D., Se l'utente desidera 
correggere quanto battuto, egli può premere le frecce destra e sinistra (FCTN D, e 
FCTN SS). Il valore del tasto della freccia sinistra è >08, mentre per la freccia 
destra è >09. Le linee da 17 a 22 controlla no queste condizioni. La linea 23 usa 
l'istruzione Compare (confronta), per confrontare l’accumulatore dell'indirizzo del 
cursore (R7)cal massimo indirizzo del cursore (RI0). Se essi sono uguali, allora la 
massima lunghezza permessa dei dati è già stata raggiunta. Quando questo è vero, non 
sono più accettati altri dati dal CURSOR, e i soli valori dei tasti battuti che CURSOR 
_ accetterà, sono ENTER e la freccia sinistra. Se il massimo dei valori permessi non è 

ancora stato raggiunto, le linee 25,26 e 27 accettano i dati dai tasti. La linea 25 
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copia l'indirizzo nel quale il dato sarà visualizzato da R7 in RO. La linea 26 
muove il valore del tasto battuto nel byte sinistro di RI, mentre la linea 27 salva il 
tasto battuto in R9. La linea 28 scrive il codice del carattere sullo schermo. La 
linea 29 incrementa R7, che è il nuovo indirizzo del simbolo del cursore. 


50 CURPUT MOV R7,R0 


31 LI RI,}1E00 
32 BLUP = @VSBW 
33 B ESCAN 


La linea 530 mette il nuovo indirizzo che il cursore occupa sullo schermo, in RÒ. 
Le linee 31 e 32 scrivono il siabolo del cursore sullo schermo. L'effetto visibile è 
che il cursore è stato mosso di uno spazio a destra, e il carattere battuto appare 
nella posizione precedentemente occupata dal cursore. La linea 33 si dirama 
all'etichetta SCAN, e ripete l'intero processo, formando un ciclo. 


34 LEFT C R7,R8 

35 JEO = SCAN 

36 MOV = R7,R0 

37 LI R1,)2000 
38 BLWP = @VSBW 

39 DEC R7 

40 JMP. = CURPUT 
41 RITE CC R7,R10 
42 JEG == SCAN 

43 MOV R7,R0 

44 LI R1,)2000 
45 BLWP = @VSBW 

46 INC R7 

47 JMP = CURPUT 
48 ENTER LI R1,)2000 
49 MOV =R7,RO 

50 BLHP = EVSBW 

Si È RB,R7 

52 RT 


Le linee da 34 a 52 dettagliano le azioni da prendere quando uno dei tasti 
speciali è premuto. LEFT muove il cursore a sinistra, e riempie il campo lasciato 
vuoto con un carattere spazio. La linea 34 controlla per vedere se l'indirizzo 
attuale del cursore (R7) è già al valore minimo (valore iniziale dell'indirizzo). 
RITE fa giusto il contrario di LEFT. Downloaded from www.ti99iuc.it 

ENTER è l'etichetta a cui il programma salta quando egli ha deterainato che 
l'utente del computer ha premuto Enter, segnalando la fine dell'ingresso dei dati. Le 
linee 48, 49, e 50 rimuovono il cursore dall'ultima posizione dello scherao. La linea 
51 usa l'istruzione di Word SUBTRACT “"S" (sottrai). I contenuti di RB sono sottratti 
dai contenuti di R7, ed il risultato viene messo in R7. Questa azione sottrae 
l'indirizzo iniziale del cursore in R8, dall'ultimo indirizzo dello stesso, in R7. La 
differenza tra i due è la lunghezza attuale del dato che è stato battuto. 
L'istruzione RT alla linea 52 ritorna al programaa di chiamata. 


Supponiamo che una particolare applicazione richieda a chi usa il computer il 
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nome e cognome. La massima lunghezza del dato che sarà accettata è stata determinata 
in 50 lettere, (30 bytes). E anche stato deterginato che il dato sarà accettato alla 
riga 10, e colonna i. Qui sotto vi sono le parti del programma che vi suggeriscono e 
accettano questi dati. 


PROMPT TEXT ENTER FULL NAME ‘ 


LI R0,256 Presenta il messaggio di proapt alla riga 9, 
e colonna I 

LI RI PROMPT 

LI R2,16 

BLWP @VMBW 

LI R0,288 Riga 10 e colonna 1 

LI R10,30 Lunghezza del dato 

BL ECURSOR Ottiene il dato 


A questo punto il nome inserito è visualizzato sullo schermo, iniziando alla riga 
10 e colonna i, e risiede in VDP RAM agli indirizzi da 288 a 317, purchè la lunghezza 
attuale del dato sia 30. Per fare uso di questi dati nel programma, voi dovrete 
ottenerlo dal VDP RAM. Per realizzare questo, voi necessiterete della routine VDP 
MULTIPLE BYTE READ "VMBR" (Lettura di più byte nel VDP)., In alternativa voi potreste 
anche usare VDP SINGLE BYTE READ “"VSBR" (lettura di un solo byte in VDP). 

Cueste routines operano in maniera molto simile a VMBW e VSBW, la sola differenza 
è la direzione in cui il dato viene mosso. Una lettura muove il dato dall'esterno del 
programaa al programma stesso. Una scrittura muove invece il dato dall'interno del 
programma a qualche punto all'esterno del programma stesso, come il VDP RAM. 6li 
stessi registri sono usati per gli stessi parametri. RO è usato per l'indirizzo in 
VDP RAM. RI e R2 regolano l'indirizzo in CFU RAM. Usando VSBR e VMBR con l'E/A deve 
essere inclusa una direttiva REF, 


NAME BSS 30 Mette da parte temporanearente memoria per il nome. 


LI RO, 288 Carica RO con loindirizzo in VDP RAM 

LI RI,NAME Carica RI con l'indirizzo in CPU RAM 

LI R2,30 Carica R2 con la lunghezza del dato. 
(presumendo che esso sia lungo 30 bytes) 

BLWP  @VMER Esegue un VMBR 


Ricordate che tutti i dati appaiono uguali al computer, infatti ogni cosa è 
rappresentata come un'espressione binaria. Quando voi programmate in linguaggio 
ASSEMBLY, siete voi che dovete decidere coae il dato deve essere interpretato. Se, 
per esempio, un byte di memoria contiene il valore di >41, voi dovete decidere se 
indica il codice ASCII della lettera "A", o deve essere trattato come valore puramente 
numerico, cioè 65, 

INPUT X in BASIC vi permetterà di inserire solo una stringa numerica, ogni altra 
cosa viene rifiutata. Nel linguaggio ASSEMBLY voi dovete provvedere a esaminare ogni 
ingresso del dato, per vedere se esso è numerico, e rifiutarlo se non lo è. Poichè la 
routine del CURSOR accetta dati di lunghezza variabile, voi dovrete anche decidere se 
la lunghezza variabile è peraessa, o i dati devono essere di lunghezza fissa. 
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Provate a richiamare una stringa numerica, da utente a tastiera. Per 
semplificare questo esempio, è richiesto che il numero sia esattamente di quattro 
cifre, numero intero, o tutti zeri, 


PROMPT TEXT ’ENTER A 4 DIGIT NUMEER' Definisce il prompt del 
pnessaggio. 


NMTEST DATA >3039 L'etichetta "NMTEST" contiene >}30, per il 
codice ASCII di "0", e >}39 per “9” 

NUMBER BSS 4 Riserva memoria per i numeri. 

GETNUM LI R0,256 Indirizzo dello schermo per il proapt; Riga 9 


e Colonna I 
LI Ri,PROMPT indirizzo del pronpt. 


LI R2,22 Lunghezza del pronpt 

BLWP EVMBW Visualizza il prompt 

LI R0,288 Indirizzo dello schermo per la risposta al 
prompt 

LI R10,4 Massima lunghezza della risposta. 

BL ECURSOR Ottiene la risposta 

C R7,4 Se la lunghezza della risposta non è 
4, ripetepg il prompt, e prova ancora. 

JINE GETNUM i 

LI R0,288 Indirizzo della risposta. 

LI RI,NUMBER Dove mettere la risposta. 

LI R2,4 Lunghezza della risposta. 

BLWP EVMBR Legge la risposta dal VDP RAM in CPU RAM 

CLR _R3 Fissa R3 a zero. 


TEST CB @ENUMBER(R3) ,ENMTEST Confronta il byte di “NUMBER", più 
il valore di R3 con il byte 
all'indirizzo “"NMTEST®" la prima 
volta per R3=0, così, NUMBER + 0. 
Il byte a NMTEST = >30, o "0". Se 
il byte a NUMBER + R3 è minore di 
>}30, egli non può essere un numero 
ASCII valido. 

JLT GETNUM Vai a GETNUM e prova ancora. 

CB ENUMBER(R3) ,ENMTEST+1! Confronta il byte a NUMBER+RS3 
con il byte a NMTEST#+1. Il byte 
a NMTEST+1 è = a )}359, o "9". Se 
il a NUMBER+R3 è maggiore di 
>)39, egli non può essere un 
numero valido. 


J6T GETNUM 
INC R3 Aggiunge 1 a R3 
CI R3,R7 Confronta R3 con R7 (R7 contiene 4) 


JNE TEST Se R3 non è uguale a R7, Torna 
indietro ed esegui il ciclo TEST ancora, 


se il controllo per la lunghezza di 4 viene sostituito con un controllo per una 
lunghezza di 0, allora queste istruzioni vi permetteranno una lunghezza variabile dei 
dati. Esenpio: 


dÒ 


MOV R7,R7 
JEG  BETNUM 


Adesso una stringa di 4 cifre è stata recuperata. I valori attuali della stringa 
sono codici ASCII di numeri. La sequenza dei simboli numerici rappresentano un numero 
decimale. Se voi volete usare il valore di questa risposta per qualsiasi tipo di 
aritmetica ovunque nel vostro programma, essa deve essere convertita in un valore 
binario. Qui vi è una sequenza delle istruzioni in linguaggio ASSEMBLY del TMS9900 
che fa proprio questo. 

Questa routine lavbrerà solo per numeri decimali non superiori a 655536, il valore 
massimo per una Word di memoria. Per usare questa routine in un progranma, mettete la 
stringa di numeri in NUMBER, e la lunghezza della stringa in RA4, ed eseguite una BL 
@CONVRT. Il risultato sarà in RS, al completamento della routine, nel formato intero 
binario. Se il numero da essere convertito è troppo grande, RS sarà messo a zero. 
Questa routine presume che voi stiate passando ad essa una stringa nuaerica valida. 
Perciò voi dovete controllare i simboli nunmerìci ASCII, prima di eseguire questa 
routine, allo scopo di ottenere un risultato pienamente significativo. 


DTEN DATA >000A 


NUMBER BSS è 


01 CONVRT CLR RO 


02 CLR- RI 

03 CLR R3 

04 CLR RS 

05 MOVN DEC RA 

06 MOVB @NUMBER(R4),R2 
07 SRL R2,8 

08 AI R2,-)30 
09 MOV RO,RO 
10 JINE EXP 

11 LI RO,I 

12 JMP ACCUN 
13 EXP MPY EDTEN,RO 
14 MOV RI,RO 
15 MPY R1,R2 
16 MOV R3,R2 
17 ACCUM A R2,R5 
18 JINO NEXT 

19 CLR RS 

20 RT î 

21 NEXT MOV RA,RA 
22 JNE MOVN 

23 RT 


Ecco come questa routine esegue la conversione dal codice ASCII, a quello 
BINARIO, ... e anche qualche nuova istruzione Per aiutarvi a comprendere la logica 
della routine, presumete che il numero da essere convertito sia il decimale 234. 
Internamente il valore all'indirizzo "NUMBER" può essere rappresentato da una serie di 
numeri HEX, ciascuno dei quali rappresenta un byte. R4 contiene il valore 3, la 
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lunghezza della stringa. 


Le linee da 1 a 4 puliscono i reqistri che saranno usati nella routine, La linea 
5 DECrementa (cioè, sottrae 1 da...) R4. R4 contiene la lunghezza della stringa. La 
linea 6 accede alla cifra più bassa usando l'indirizzo di base di NUMBER, più il 
proprio spiazzamento. La stringa è composta di 3 cifre, e il valore dello 
spiazzamento delle cifre, che va dai valori più alti a quelli più bassi, sono; 0, 1, 2 
( per 234, NUMBER + 0 = >32, = SO ASCII per il numero 2, NUMBER + 1 = >353, = SI ASCII 
per il numero 3, e infine NUMBER + 2 = >34, = 52 ASCII per il numero 4). Il valore 
dello spiazzamento per l’ultimo byte in una data serie di byte, è SEMFRE UGUALE AL 
NUMERO DI BYTE MENO 1, in questo caso 3-1=2, "MOVN" è l'etichetta che sarà usata per 
creare un ciclo. 

La prima volta attraverso il cicl, la linea 6 muove il byte di valore inferiore , 
le unità nel numero 234, cioè 4 (NUMBER + il valore in R4, = NUMBER + 2) a R2. R2 ora 
contiene >3400. La linea 7 esegue un SHIFT RIGT LOGICAL “SRL" (Spostamento logico a 
destra) su R2 di B posizioni a destra. R2 adesso contiene >}0034. La linea 8 usa 
l'istruzione ADD IMMEDIATE "AI" (Addiziona immediatamente), per togliere la maschera 
di >SI0. Usando un valore di -)30, l’effetto sull'istruzione AI, è quello di una 
sottrazione. 


Il registro 2 ora contiene >0004. Poichè la sequenza dei numeri è decimale, voi 
dovete moltiplicare ogni cifra della potenza di dieci che corrisponda alla stessa 
posizione in sequenza. La cifra nella posizione più bassa di un numero decirale 
rappresenta l'unità. La prima cifra che avete estratto moltiplicata per 1 (unità) 
dovrebbe essere uguale a se stessa. Dunque, la cifra più bassa può essere usata cooe 
è. La linea 9 muove RO a se stesso, così che la linea 10 può controllare RO per un 
valore di zero. JUMP if NOT EQUAL “JNE" (salta se non uguale). La prima volta RO è 
uguale a 0, e l’istruzione JNE della linea 10 non ha effetto. La linea 11 Carica 
Immediatamente "LI" RO con il valore di 1. La linea 12 esegue un salto incondizionato 
(JMP) all’etichetta ACCUM. 


Continuiamo con la linea 17 ACCUM, che addiziona i contenuti di R2 e RS. Il 
valore in RS (che è stato usato come accumulatore per questa routine) potrebbe 
diventare troppo grande, e riempire RS, così il bit di traboccamento (0V) verrà 
fissato a 1 nel registro di status (ST). La linea 18 controlla questa condizione con 
l'istruzione JUMP if NO OVERFLOW "JINO"” (salta se non c’è traboccamento). Finchè il 
bit di traboccamento non è fissato a 1, l'istruzione logica continua all'etichetta 
NEXT. Se il bit di traboccamento è messo a Ii, allora le prossime due istruzioni 
puliscono RS, e ritornano al programma di chiamata. Alla linea 21, NEXT muove R4 a se 
stesso, La linea 22 controlla R4 per un valore di zero, esaminando il bit di 
uguaglianza nel registro di stato (ST). Se R4 è uguale a zero a questo punto della 
subroutine logica, il. suo compito è fatto, e la linea 23 ritorna all'indirizzo del 
prograsma chiamante. la prima volta R4 è uquale a 2, e la routine salta all'etichetta 
MOVN. 


Il secondo passaggio per la routine prende un corso leggermente diverso. RA4 
viene decreaentato di 1. La linea 6 muove il prossimo byte del numero (>33) a R2. R2 
viene spostato di 8 posizioni a destra, e diventa >0033, e la maschera di >30 è tolta; 
dando >00053. RO ora contiene 1, così la linea 10 scatta un salto all'etichetta EXP 
alla linea 13. 


La linea 13 usa l'istruzione MULTIPLY "MPY" (aoltiplica), per calcolare la 
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potenza di 10 che corrisponde alla posizione relativa della cifra decimale. 
L'istruzione MPY moltiplica il primo e il secondo operando (che deve essere un 
registro), e usa due registri successivi come fa l'istruzione DIVide. Come DIVide 
l'uso di un secondo registro è implicito, significando che il registro addizionale non 
è specificato in nessuna parte dell'istruzione. Nell'esempio, DTEN viene moltiplicato 
dai contenuti di RO, e il risultato finisce in RI perchè RI è il prossimo registro 
dopo RO. Ora esaminate il contenuto dei registri implicati: 


PRIMA DI MPY DTEN = }000A RO = >0001 RI = >0000 
DOPO MPY " = )000A RO = 30000 R1 = >000A 


Se il risultato di una moltiplicazione dovesse essere più grande di una Word, 
egli resterà nel registro nominato. SÎn questo esempio il registro 0 contiene i bit 
più importanti, e il registro 1 contiene i bit meno importanti. L'istruzione MPY non 
ha effetto sul registro di stato (ST). 


La linea 14 muove il risultato di 10, che è in RI, in RO. Ciò è fatto per 
preparare RO al prossimo ciclo. fid ogni passaggio per il ciclo, RO sarà moltiplicato 
per 10. In questa maniera, i contenuti di RI saranno uguali alla potenza di 10 
necessaria per ogni posizione decimale (i, 10, 100, 1000 ecc.). Ricordate che un 
movigaento copia soltanto i contenuti di una locazione ad un’altra. I contenuti di RI 
sono sempre intatti. Alla linea 15, il valore in R2, che è il numero da essere 
convertito (>00053) viene moltiplicato per il valore in Ri (la potenza del dieci per la 
posizione di questo numero). Ecco l’effetto della moltiplicazione della linea 15: 


PRIMA DI MPY RI ?2000A R2 = 30005 R3 = >0000 


2000A R2 = >0000 RS = >OO0LE 


DOPO MPY RI 


Il risultato finisce in R3, il primo registro disponibile dopo R2, che era il 
registro nominato nel secondo operando dell istruzione MPY. La linea ié, muove il 
risultato in R2. Questo viene fatto perchè la linea 17, ACCUM, si aspetta che il 
valore da essere addizionato a RS debba essere in R2. 


Il ciclo viene ripetuto un'altra volta per estrarre la cifra più alta. Questa 
cifra rappresenta le unità di 10 o 100. Il numero estratto è due. Moltiplicato per 
100, diventa uquale a 200. Addizionato a RS da ACCUN, porta il valore totale di RS a 
)Q0EA, o 234 Dec. Il valore in RS può ora essere usato per qualsiasi calcolo 
ariteetico di cui avrete bisogno. 


Voi non avrete bisogno di usare una routine estesa come CURSOR, nel vostro 
programma interattivo con l'ingresso da tastiera, o per fare buon uso di una ‘utilità 
come KSCAN. Nei primi due programai esempio, l'indirizzo di ritorno era stato 
alterato con lo scopo di permettervi di osservare i risultati del programma stesso. 
Adesso che conoscete qualche cosa su KSCAN, c'è qui un modo migliore per terminare un 
programna. L'indirizzo di ritorno è inalterato, e, allo scopo di creare una pausa, 
KSCAN viene usata per rivelare la pressione di un qualsiasi tasto. Il programma 
attenderà finchè non sia premuto un tasto, e poi termina. Ecco una parte di progranma 
che fa proprio questo: 
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E0J CLR @STATUS Fulisce il GPL STATUS byte 
SCAN BLWP EKSCAN Eseque la scansione delia tastiera 
MOVE ESTATUS,ESTATUS Confronta il GFL STATUS byte con >}00 
JEQ SCAN Se nessun tasto è stato premuto, esplora ancora 
MOV  ESAVRTN,RII Muove l'indirizzo di ritorno a RII 
CLR ESTATUS Pulisce il GPL STATUS byte 
RT RETURN per mezzo di RII 


Un'altra applicazione di ESCAN è la rivelazione della pressione dei tasti 
speciali, come CLEAR o QUIT. Ricordate che quando il vostro programma nel linguaggio 
ASSEMBLY del TMS9900, sta girando,egli è sotto il completo controllo del computer. 
Allo scopo di poter uscire dal programma, il programma stesso deve provvedere a 
rivelare l’uso di un simile comando. Poichè questi tipi di tasti non rappresentano 
dati visualizzabili, non c’è bisogno di una routine come quella del CURSOR. 
Dipendentemnente da come programaate le azioni da essere prese per i vari valori di 
controllo, il vostro computer può rispondere conformemente a questi comandi. Ecco una 
parte di programma per rivelare la pressione del tasto QUIT (FCTN=): 


QUITV RYTE > 05 
SCAN CLR @esTATUS Pulisce il GFL STATUS byte 


BLWP @KSCAN Esegue la scansione della tastiera 
MOVE ESTATUS,ESTATUS Vede se un tasto è stato premuto 


JEO SCAN Altrimenti esplora di nuovo 

CR EQUITV,€KEYVAL Vede se il tasto QUIT è stato premuto 
JE ABORT Se lo era, fine del lavoro 

RT Altrimenti RETURN 


IMPORTANTE: Prima di uscire da un programma con QUIT, assicuratevi di chiudere 
qualsiasi file aperto. 


La risposta normale alla pressione del tasto QUIT (FCTN =), quando si opera in TI 
BASIC, EX/BASIC, e la maggior parte delle utilità, è per il conputer, il ritorno al 
titolo principale di schermo, (Quello a barre colorate). Ecco quì sotto la parte del 
programma che fa questo: 


GPLWS EGQU >BIEO 


ABORT LIMI 2 Attiva le interruzioni 
LWPI GPLWS Carica i registri workspace GPL 
BLWP @>)000T0 Si dirama al vettore >0000 


L'istruzione LIMI sta per "LOAD INTERRUPT MASK IMMEDIATE" (Carica immediatamente 
la maschera d’interruzione), ed è usata per attivare/disattivare le interuzioni., LIMI 
0 (Interruzioni disattivate) è lo stato normale del computer. Questa istruzione mette 
i quattro bit meno importanti del contenuto dell’operando immediato nella maschera 
d’interruzione del registro di STATUS. 

Senza interruzioni, la. CPU processa un'istruzione o un dato, uno dopo l'altra. 
Questa sequenza del processo si ripete ad ogni impulso costante. Certe operazioni, 
richiedono che voi interrompiate questo processo regolarmente, normalmente per 


59 


permettere le diverse velocità dei microprocessori che compongono un computer. LIMI 2 
attiva le interruzioni ai livelli 0, 1, e 2. Poichè la diramazione per >0000 ritorna 
al titolo principale dello schermo, per mezzo della routine GPL residente, è 
necessario avere il registro WP puntato al Workspace usato dal GPL. 


Ecco quì un a tabella che da i valori dei tasti numerici premuti, in combinazione 
con il tasto FCTN. 


VALORE DEL TASTO PREMUTO 


COMBINAZIONI NOME DECIMALE HEX 
FCTIN 1 DELETE 03 203 
FCTN 2 INSERT 04 204 
FCTN 3 ERASE 07 >07 
FCTN 4 CLEAR 02 >02 
FCTN 5 BEGIN 14 >OE 
FCTN 6 PROCEED 12 >OC 
FCTN 7 AID 01 >01 
FCTN 8 REDO 06 206 
FCTIN 9 BACK 15 >OF 
FCTN 0 188 > BC 
FCTN = QUIT 05 205 


Buello che segue è un programaa d'esempio che dimostra alcuni dei principi della 
routine KSCAN. La grafica per il bordo dello schermo, e per il prompt, usano la 
stessa logica del programma esempio del capitolo sesto. @uando esso gira, qualsiasi 
tasto che voi premete farà visualizzare il carattere battuto, (purchè esso risulti 
visualizzabile), ed il valore decimale del tasto o combinazioni di tasti. Il prossimo 
pronpt accetterà solo REDO o ESCAPE. REDO ripete l’intera sequenza, mentre ESCAPE vi 
ritornerà al titolo principale dello schermo. Voi potete usare questo programaa per 
trovare il valore di ogni tasto, o combinazione di tasti premuti. 

La routine FIGUR usa la stessa logica del primo programma esempio, quello per 
convertire una cifra binaria nel corrispondente codice ASCII visualizzabile. FIGUR 
usa un ciclo per permettere ad esso di processare qualsiasi numero idoneo in un solo 
registro. FIGUR tratta la convesrione e visualizza il valore. 


«PROGRAMMA ESEMPIO DI INGRESSO DA TASTIERA 
*VERSIONE E/A 


DEF 60 

REF VUTR,VSBW, VMBW,KSCAN 
WR BSS >20 Mette da parte spazio per WS 
STATUS EQU >837C STATUS byte GPL 
KEYADR EQU })B374 Indirizzo della tastiera 
KEYVAL EGU )B375 Indirizzo del tasto premuto 
DTEN DATA >A Decimale 10 


BORDER DATA >FFFF,)2020,)2020,)2020 Definisce il pattern del bordo 
DATA >2020,>2020,)2020,}2020 
DATA >2020,)2020,)2020,}2020 
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>2020,)2020,>2020, >FFFF 


MSGI TEXT ‘#4 PRESS ANY KEY *#' Definisce il primo prompt 
MSG62 TEXT ‘’# KEYSTROCHE VALUE IS #' Definisce il secondo proapt 
M563 TEXT ‘’# PRESS REDO/ESCAPE *' Definisce il terzo pronpt 
REDOV BYTE >06 Valore per "REDO” 
ESCPV BYTE >OF Valore tasto “ESCAPE” 
SAVII BSS 2 
60 MOV Ri1 ,€@SAVII Salva l'indirizzo di ritorno 

LWPI WR Carica il LUPI 

LI R0,070D Fissa il colore di sfondo 
% del bordo come magenta 

BLWP _@VHTR 

LI RO, )039F Fissa il caratter del bordo 
% come magenta 

LI Ri,>DD00 

BLWP  @VSBW 

LI R0O,})580 Caratteri bianchi su nero 

LI R1,)1F00 i 
CLOOP BLUP  @VSEN 

CI R0,}039E 

JE BPUT 

INC RO 

JMP CLOOP 
BFUT LI R0,0 Carica i caratteri del bordo 

LI Ri,BORDER 

LI R2,32 
BLOOP BLUP  @VMEW 

CI R0,736 

JEQ EXIT 

AI RO, 32 

JMP BLOOP 
EXIT LI R0,261 Presenta il primo prompt 

LI Ri ,MSGI 

LI R2,22 

BLWP  €VMBW 

CLR EKEYADR Pulisce KEYADR e KEYVAL 
SCANI CLR ESTATUS Pulisce il GPL STATUS byte 

BLWP  @KSCAN Esegue KSCAN 

MOVB E@STATUS,E@STATUS Vede se un qualsiasi tasto 
* è stato premuto 

JER SCANI Altrimenti esplora ancora 

LI R0,325 Presenta il secondo prompt 

LI R1,M562 

BLUP  @VMBWH 

LI R0,395 Visualizza i caratteri dei 
* tasti 

MOVB @KEYVAL,R1 

BLHUP  @VSBW 

MOVB E@KEYVAL,R4 

SRL R4,B 

LI R35,404 Visualizza il valore 
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decimale dei caratteri 


LI R0,406 


BL @eFIGUR 
LI RO,485 Presenta il terzo prompt 
LI R1,MS63 
LI R2,22 
BLWP  @VMBW 
SCAN2 CLR ESTATUS Esegue ancora KSCAN 


BLWP EKSCAN 
MOVB  E@STATUS,ESTATUS 


JEQ SCAN2 

CB @KEYVAL,EESCPV ESCAPE 0 REDO preauti? 

JE ESCAP Se ESCAPE, salta a ESCAP 

CR EKEYVAL, EREDOV 

JNE SCAN2 

B EBPUT Se REDO salta a BPUT 
FIGUR MOV R4,RS fRoutine per convertire i 
* numeri interni in nuneri 
* decimali visualizzabili 
* Ingresso: R4=valore, R5= 
* primo indirizzo sullo 
* schermo del risultato 
* RO=sultimo indirizzo 
* sullo schermo 

CLR R4 

DIV @DTEN,R4 

AI RS, 230 

SLA RS5,8 

MOV RS,RI 

ELWP  EVSEW 

DEC RO 

Cc RO,R3 

JHE FIGUR 

RT 
ESCAF CLR @ESTATUS Pulisce lo STATUS byte 

MOV @SAVII,RII Ritorna 

RT 

END 


MANUALE DI RIFERIMENTO E/A 


I seguenti riferimenti vi forniranno altre informazioni sull'ingresso dalla 
tastiera 

Sezione 10-2 pag.i64 

Sezione I16-2 pag.250 

Dalla sezione 16-3 pag. 264, alla sezione 16-3-1 pag.264 

Dalla sezione 24-11 pag.440, alla sezione 24-11-53 pag.442 


GUARDARE QUESTI TERMINI SUL GLOSSARIO 
ASCII 

Console 

Bit della maschera d'interruzione 
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CAPITOLO NOME 
TRATTAMENTO DEI FILE 


La creazione, la lettura, e l'aggiornamento dei dati di un FILE, attraverso il 
linguaggio ASSEMBLY del TMS9900, è un’altra importante funzione che coinvolge il VDP 
RAM. Le speciticazioni del FILE che descrivono la iunghezza del record, la lunghezza 
del formato, formato dei file e dati, e modi di operazione, sono accumulati in un 
blocco di memoria conosciuto come "PERIFHERAL ACCESS BLOCK" (PAB) (Blocco d'accesso 
periferiche) 

Il PAB dettaglia tutte le informazioni richieste dal coaputer per riconoscere ed 
accedere ai file che volete. La lettura, scrittura e aggiornamento dei dati del file, 
è trattato da una routine residente chiamata "DEVICES SERVICE ROUTINE" (DSR) (Routine 
del dispositivo di servizio). 

Il trattamento dei file è implementato attraverso il linguaggio ASSEMELY del 
TMS9900 manipolando i dati dentro il PAB per un file, e creando i dati disponibili nel 
FAB, per il corretto DSR. 

Guando programmate in TI BASIC, voi fornite tutti i paraaetri sopra un file, 
nell'istruzione OFEN, la quale apriva il file e specificava come dovevano essere usati 
INPUT, OUTFUT, UPDATE, o AFPEND. Il file era poi accessibile dentro al programaa 
dalle istruzioni INPUT o PRINT. Quando poi avevate finito con il file , era 
necessario chiuderlo. Queste quattro funzioni del file, che lo definiscono, lo 
aprono, lo leggono o scrivono, ed infine lo chiudono, sono sempre richieste da 
qualsiasi linguaggio di programmazione. Il linguaggio ASSEMBLY del TMS9900, richiede 
ancora qualche linea di codice in più, per ottenere lo stesso risultato del TI BASIC, 
ma il trattamento dei file non è generalmente molto complesso. 


Il primo passo è quello di definire le caratteristiche del file al computer. I 
byte dei dati che creano un FAE, definiscono i parametri chiave del file. Il numero 
attuale dei byte che creano un PAB è variabile, dipendendo dal none del 
dispositivo/file selezionato. I) priao byte (il byte zero) del FAB istruisce il DSR 
sul tipo di operazione che voi desiderate esequire; (Open, Read, Write, Close, etc.) 
(aprire, leggere, scrivere, chiudere, etc.). Il fissaggio iniziale di questo byte per 
la maggior parte dei file dovrebbe essere >}00, o OPEN. 

Ecco gli OP-CODE (codici operativi) disponibili per il byte zero del PAB. 


VALORE OPERAZIONE 
>00 OPEN 
>O1 CLOSE 
> 02 READ 
703 WRITE 
904 RESTORE/REWIND 
> 05 LOAD 
)06 SAVE 
>07 DELETE FILE 
)09 STATUS 


L'OP-CODE >08 (Scratch Record) (cancella record) non è generalmente usato dal 
TI-99/4A,perchè il disk controller non permette ad un record di essere cancellato. 


Il prossimo byte del PAB (il byte i)controlla parecchie funzioni, dipendendo da 
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quali bit sono messi ON o OFF ( accesi o spenti, 1 o 0), esso definisce il modo di 
apertura (OFEN) (input ,output;update), tipo di record (fixed o variable) (di lunghezz 

fissa 0 variabile), il tipo di dati contenuti (Display, o internal) (formato 
visualizzabile o interno), e se il file deve essere sequenziale o relative (ad accesso 
casuale). Tutti questi parametri sono definiti da varie combinazioni dei bit da 3 a 7 
del byte 1. I bit 0, 1, 2 sono usati per riportare le varie condizioni di errore che 
possono capitare. Il fissaggio iniziale dei bit 0, 1, e 2 dovrebbe essere senpre 
zero, (nessun errore). 

Ecco un sommario dei valori del byte 1 del PAB, ed i loro significati. 


PAB BYTE 1 VALORI E SIGNIFICATO 


FILE RELATIVI - (Tutti i file relativi sono di lunghezza FIXED 


201 UPDATE, DISPLAY 
>03 OUTPUT, DISFLAY 
205 INFUT, DISFLAY 
709 UPDATE, INTERNAL 
> 06 OUTPUT, INTERNAL 
> OD INPUT, INTERNAL 


FILE SEQUENZIALI 


>02 OUTFUT, FIXED, DISFLAY 

>04 INPUT, FIXED, DISPLAY 

)06 APFEND, FIXED, DISPLAY 

>OA OUTFUT, FIXED, INTERNAL 
>OC INPUT, FIXED, INTERNAL 
)OE APPEND, FIXED, INTERNAL 
>12 OUTFUT, VARIABLE, DISPLAY 
>14 INPUT, VARIABLE, DISPLAY 
»ié APFEND, VARIABLE, DISPLAY 
DIA OUTPUT, VARIABLE, INTERNAL 
d1C INPUT, VARIABLE, INTERNAL 
>LE APPEND, VARIABLE, INTERNAL 


I byte 2 e 3 (una word) contengono l'indirizzo in VDP RAM che deve essere usato 
come un buffer (spazio di memoria temporaneo) per ogni record che viene letto o 
scritto. Il byte 4 definisce la lunghezza logica del record in byte. Per una 
lunghezza variabile questo valore indica la massima lunghezza del record. Il valore 
più grande che può essere definito usando un byte è >FF, o 255. Il byte S definisce 
il numero di byte da scrivere con un'operazione di scrittura, o il numero di byte da 
leggere, con un'operazione di lettura. 

Per un record di lunghezza FIXED (fissa), i byte 4 e 5 del FAB dovranno essere 
fissati sempre uguali sia in scrittura che in lettura. Per record di lunghezza 
variabile, il byte 5 del PAB può essere esaminato per deterainare la lunghezza 

del record in lettura, e può essere cambiato dinamicamente per ogni scrittura. 
Il valore del byte 5 del PAB non può mai essere maggiore della lunghezza logica, 0 
massima del record. I byte 6 e 7 del PÀAE (una word) vengono usati solo per file 
relativi (ad accesso casuale). Questa word contiene il numero del record relativo a 
cui accedere. Il bit più importante di questa word è ignorato, così che la gamma dei 
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valori possibili parte da zero (il primo record di un file relativo) fino a 
32.767. Il byte 8 è usato solo per i file memorizzati su un dispositivo a cassette 
(registratore). 

Il valore in questo byte è il totale dell'offset dello schermo (>60 in BASIC, >00 
in ASSEMBLY). Il DSR della cassetta ha bisogno di questo valore per il proaspt 
(messaggio) sullo schermo, che deve visualizzare le operazioni per il registratore. 
Il byte 9 indica la lunghezza del descrittore del file, che comincia nel byte 10. La 
descrizione del file può essere di lunghezza variabile. 

Quì viene indicato dove mettere il FILE/DEVICE NAME (Nome del dispositivo) che 
avete scelto per il vostro file. ("CS1”, “"DSKi.", “RS232.BA=300"”, etc.). poichè la 
lunghezza di questo input varierà in dipendenza del dispositivo selezionato, il 
computer necessita di questi dati nel byte 9. 

Ecco come dovrebbe essere codificato un PAB in un prograama in linguaggio 
ASSEMBLY del TMS9500. 


FAE DATA 20012 STO 25000, 20000, E 


L Lunghezza del descrittore 

del file 

Offeset per lo schermo 

(per DSR a cassette) 

Numero deì record relativi 

—————_—_m€ vContatore dei caratteri 

Lunghezza record: >50 (80) 

I o —__dirizzo buffer in VDF RAM 

(simbolico o effettivo) 
1 _P——______________ Tipo di file: )12 = OUTFUT, 

VARIABLE, DISPLAY, SEQUENT. 

Operazione: )00 = OPEN 


TEXT ‘’DSKI.FILEIL" 


i 


Descrittore del file 
(Questo descrittore è lungo 
>OA (10) caratteri) 


I PAB sono codificati nel vostro programma, e poi messi in VDP RAM con una 
routine come VMBW. Il VDP RAM è usato da tutti i DSR per PAB e spazio buffer. Poichè 
ci sono tavole e altri dati qmolto importanti in VDF RAM, solo certe aree saranno usate 
per il FAB e buffer. Il primo indirizzo libero in VDP RAM normalmente usato per i FAB 
è >FBO. Cuesto indirizzo effettivamente si sovrappone alla fine della Tavolà 
Descrittrice dei Pattern, ma i codici dei caratteri da >FO a FF non sono definiti cone 
visualizzabili, così questo normalmente non causa problemi. 

Lo spazio libero in VDP RAM si estende attraverso l'indirizzo >37D6. Questo 
rappresenta uno spazio totale considerevole per il PAB e le necessità del buffer, 
State attenti a usare questo spazio solo per queste funzioni. Dove molti file devono 
essere usati, deve essere riservato spazio a sufficienza tra i PAB e i buffer per 
assicurare l'integrità dei dati del file . 

Qui ci sono parti di programma che stabiliscono un PAB e un buffer: 


BUFADR EQU >»>1000 Indirizzo VDP RAM per buffer record 
PABADR EQU >0F80 Indirizzo VDP RAM per il PAB 
PAB DATA >0012,BUFADR,?5000,70000,)0009 
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TEXT ’DSKI.FILE 


LI RO, PABADR 
LI RI, PAB 

LI R2,20 
BLWP VMBW 


Una volta che il PAB ed il buffer per il file sono stati stabiliti, l'effettivo 
accesso è compiuto per mezzo del DSR. Funtando al PAB (definizione del file) a cui 
avere accesso, manipolando il byte zero del FAB (operazione), e diramandosi al DSR, il 
file può essere aperto, letto, scritto, chiuso, etc. Il DSR per tutte le periferiche, 
eccetto le cassette, è accessibile includendo una REF DSRLNK nel vostro prograasa, 
usando l’E/A, oppure una direttiva EQU all'indirizzo >6038, con alcune etichette se 
usate l'assembler LINEA per LINEA. A 

La DSR per le cassette è una routine GPL (6raphics Programming Language) 
(Linguaggio di programmazione grafico) situato in GROM (Graphics Read Only Meaory) 
(memoria di sola lettura grafica). Il trattamento dei file da cassetta, e DSR saranno 
discussi più tardi. Il puntatore necessario per DSRLNK è l'indirizzo del byte del 
descrittore del file. Questo valore deve essere messo nella word all'indirizzo )}8355. 
Fer l'esempio di cui sopra, allora 


LI R6,PAB+9 
MOV R6,€>8356 


DSRLNK viene poi richiesto con una istruzione BLWP. Il DSRLNK ha 
bisogno anche del valore 8 per coapletare l'istruzione. 


BLWP  EDSRLNK 
DATA 8 


La stessa istruzione DSRLNK è usata per qualsiasi operazione su qualsiasi file, 
escluse le cassette. Le reali operazioni eseguite su di un file da ogni BLWP a DSRLNK 
(open, read, ect.)dipende dal valore nel byte zero del FAB. Il file accessibile 
dipende dal valore messo a >8356. Il DSKRLKK determinerà se le caratteristiche del 
file corrispondono al dispositivo, e se l'operazione richiesta è compatibile con le 
caratteristiche del dispositivo/file. Gli errori di questo tipo, come EDF (del disco) 
(End Of File) (fine del file) e altre condizioni del processo sono rivelate da DSRLNK 
e riportate nei bit 0, 1, e 2 del byte 1 del PAB. Presumendo che non capitino errori 
durante il processo del file, DSRLNK tratta tutti gli aspetti del processo, cone 
un’'aggiornamento del catalogo entrate per un file su disco. 

Il programma nel linguaggio ASSEMBLY del TMS9900, deve controllare le condizioni 
di errore, e provvedere, come risultato, alle azioni da prendere. Quando capitano 
degli errori, il bit di uquaglianza nel registro di status (ST) viene messo a 1 
(settato). Se non capitano errori, lo stesso bit viene messo a zero (resettato). 


Se il dispositivo che avete selezionato è R5232, o PIO, voi dovete salvare gli 
indirizzi di lettura e scrittura GROM priaa di ciascun BLWP @DSRLNK, e ristabilirli in 
seguito. La DSR per questi dispositivi rendono questi indirizzi indeterminati. Ecco 
una parte di programma per salvare e ristabilire questi indirizzi. 


REF GRMRA 
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REF GRMWA 


SAVADR BSS 2 


MOVB EGRMRA,ESAVADR Ottiene il primo byte dell'indirizzo 


NOF 

MOVB @GRMRA,@SAVADR+1 Ottiene il secondo byte 

DEC ESAVADR Decrementa l'indirizzo 

BLWP__ @DSRLNK Accede alla routine periferiche 
DATA B 


MOVB  ESAVADR,GGRMWHA Ristabilisce il primo byte 


* dell'indirizzo 

NOP 

MOVE ESAVADRt+1,€GRMWA Ristabilisce il secondo byte 
* dell'indirizzo 


Nell'esempio sopra riportato, la pseudo istruzione "NOP" viene usata per 
pernettere un ritardo di tempo per l'accesso agli indirizzi GROM. NOP non eseque 
nessuna funzione, ma prende tempo come farebbe una istruzione reale. 

Cui c’è un programma esempio di file ad accesso sequenziale, L'input del file 
contiene record di lunghezza VARIABLE BO, nel formato DISPLAY. Ogni record contiene 
un primo nome con una lunghezza massima di li4 caratteri, ed un ultimo none. La 
lunghezza effettiva del campo dell'ultiao nome (e quindi del record) è variabile, 
benchè il primo carattere dell'ultimo none deve cominciare dalla quindicesima 
posizione. Guesto progranma legge il nose del file e seleziona il terzo record sul 
file. Il primo e l’ultimo nome del terzo record saranno poi visualizati. 


68 


0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
O0i0 
OOll 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0050 
0031 
0032 
0033 
00354 
00355 
0056 
0037 
0038 
00359 
0040 
0041 
0042 
0043 
0044 
0045 
0046 
0047 
0048 
0049 
0050 
00SÌ 


STATUS 
POINTR 
BUFADR 
PABADR 
READ 
CLOSE 
EDF 
PAB 


ERRMSG 
CFUBUF 
FNAME 
LNAME 
LEN 
RETURN 
WR 
BEGIN 


READF 


DEF 
REF 
EQU 
EGU 
ECU 
EGU 
BYTE 
BYTE 
DATA 
DATA 
TEXT 
TEXT 
BSS 
EGU 
EGU 
BSS 
BSS 
BSS 
MOV 
LWPI 
LI 
LI 
LI 
BLWF 
BL 
MDVB 
LI 
ELWP 
CLR 
BL 
MOV 
JINE 
INC 
CI 
JNE 
LI 
ELWP 
SRL 
MOV 
MOV 
LI 


BLWP 
LI 
LI 
LI 
BLWP 
LI 
LI 
MOV 
AI 


BEGIN 


DSRLNK,VSBW,VMEW,VSER,VMER 


2837C 
28356 
21000 
>F8B0 
}02 
201 
>0 


>0014,BUFADR,}5000,}0000, ?000A 
‘DSK2.FILEL” 
‘1/0 ERROR=' 


80 

CPUBUF 
CPUBUF+14 
2 

2 

> 20 


RI1 ,ERETURN 


WR 
RO, FABADR 
Ri, FAB 
R2,20 
@VMBH 
EDSR 
@READ,RI 
RO, FABADR 
EVSBW 

R4 

@DSR 
@EOF, 6EOF 
EDI 

R4 

R4,3 
READF 


Indirizzo dello STATUS byte GPL 
Indirizzo del puntatore al DSR 
Indirizzo del buffer record in VDP RAM 
Indirizzo VDPF RAM per il PAB 

Codice operativo di "READ" 

Codice operativo di “CLOSE" 
Segnalatore (FLAG) di fine del file 
Dati per il FAB 


Messaggio di errore del DSR 
Indirizzo del buffer record in CFU RAM 
Indirizzo del primo nome 
Indirizzo dell'ultiao nome 
Lunghezza effettiva del record WorkSp. 
Salva l'indirizzo dell’area di ritorno 
Registri di lavoro 
Salva l'indirizzo di 
Carica i registri di 
Indirizzo in VDP RAM 
Indirizzo in CPU RAM 
Lunghezza dei dati 
Scrive il PAB in VDP 
Apre il file 
Carica 1’'0P-CODE di READ in RI 
Carica l'indirizzo del FAB in RO 
Mette READ nel byte 0 del PAB 
Fulisce il contatore dei record 
Eseque la routine del DSR 
Controlla la fine del file 
Se EOF andare alla fine del lavoro 
Aggiunge 1 al contatore dei record 
Controlla per il terzo record 
Se non è il terzo, leggi ancora 


ritorno 

lavoro 

per il FAB 

per i dati del FAB 


RAM 


RO,PABADR+5 Indirizzo del contatore di caratteri 


€VSER 
R1,8 
RI,R2 

RI, ELEN 
RO, BUFADR 
Ri, CPUBUF 
@VMBR 

R0, 290 
RI, FNAME 
R2,14 
EVMBW 
R0,305 
RI, LNAME 
@LEN,R2 
R2,-14 


Legge il contat. nel byte sinist. di R1 


Sposta da sinistra a destra 

Muove il valore in R2 

Salva il valore dentro lunghezza 
Indirizzo del buffer record in VDP RAM 
Indirizzo del record in CPU RAM 
Ottiene il record da VDP a CPU RAM 
Indirizzo schermo per il primo nome 
Indirizzo del primo nome in CPU RAM 
Lunghezza del campo del primo nome 
Visualizza il primo nome 

Indirizzo schermo per l'ultimo none 
Indirizzo in CPU RAM dell'ult. nome 
Muove la lunghezza del record in R2 
Sottrae la lunghezza del primo none, e 
la differenza è la lunghezza 
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* dell'ultimo nome 


0052 BLWF E@VMBW Visualizza l'ultimo none 

00530 JMP EOJ Vai alla fine del lavoro 

0054 DSR LI R6,FABADR+9 Carica Ré con il descritt. della lung. 

0955 MOV R6,@FOINTR Muove l'indirizzo al Puntatore 

0056 BLWP EDSRLNK Esegue il DSRLNK 

0057 DATA 8 Dati necessari per il DSRLNK 

0058 + 

0059 JER DSRERR ‘ Controlla per errori 

0060 RT Ritorna 

0061 DSRERR INC, @E OF Fissa l'indicatore EOF 

0062 LI RO,PABADR+1 Indirizzo del byte 1 del FAB 

0063 EBLWP EVSBR Legge il byte 1 del PAB in RI 

0064 SRL _R1,13 Sposta i 3 bit più alti al posto dei 
% più bassi 

0065 CI R1,5 Controlla per il valore di EOF = 5 

0066 JNE IDERR Se non è EOF allora altro errore 

0067 RT Se è EOF allora ritorna 

0068 ICDERR AI Ri1,}530 Maschera del codice di errore 

0069 SLA R1,8 Scambia i bit di ordine basso con 
Li quelli di ordine alto 

0070 LI R0,299 Visualizza il codice di errore 

0071 ELWF_  EVSBHO + + Sullo schermo 

0072 LI R0,288 Visualizza il messaggio di errore 

0073 LI Ri ,ERRMSG 

0074 LI R2,10 

0075 BLWP @VMEW 

0076 EOJ MOV EEOF,6EOF Se è stato raggiunto EOF, allora 

0077 JINE NOCLOS Chiuderà il file 

0078 MOVB ECLOSE,RI Muove 1'OP-CODE di CLOSE in Ri 

0079 LI RO,FABADR Carica l'indirizzo del PAB 

0080 BLHP @VSBW Scrive 1’'OP-CODE di CLOSE al PAB 0 

O0B1 BL @DSR Chiude il file 

0082 NOCLOS DECT ERETURN Altera l'indirizzo di ritorno 

0083 MOV ERETURN Muove l'indirizzo di ritorno in RIili 

0084 RT Ritorna 

0085 END 

COMMENTI 


La linea 25 apre il file perchè 1’CP-CODE nel byte 0 del PAB è originariamente 
fissato a >00 (L’OP-CODE di "OPEN"). Le linee 26, 27, e 28 scrivono 1l’OP-CODE per la 
lettura (READ >02) nel byte 0 del PAB. Una volta che questo è fatto, ogni DSRLNK 
successivo esegue una lettura e continuerà ad eseguire letture finchè 1’OP-CODE non 
viene cambiato in qualche altro valore. La subroutine DSR dalle linee 54 fino a 60 
contengono le istruzioni e i dati che esegue il DSR. La linea 59 usa l'istruzione JEQ 
(Salta se uguale), per esaminare il bit di uguaglianza nel registro di STATUS (ST). 
DSRLNK fissa questo bit se ci sono degli errori. EOF è riportato come errore con un 
valore di S nei bit 0, 1, e 2 del byte 1 del PAB 

Le linee da é1 a 67 esaminano per EOF. Se EOF è stato raggiunta, allora la 
parola “"EOF" è cambiata da zero a uno. DSRLNK Chiuderà il file per voi se è stato 
raggiunta EOF. Per questo progranaa esegpio la EOF capiterà solo se il file conteneva 
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meno di 3 record. Se la condizione riportata è un pò oltre la fine del file, le 
linee da 68 a 75 visualizzano il codice di errore ed un messaggio. 


Le linee da 30 a 53 spiegano dettagliattamente le azioni che leagono attraverso 
il file finchè il terzo record è trovato. Le linee 36 e 37 estraggono il contatore di 
caratteri dal byte 5 del PAB. VSBR legge dall'indirizzo in RO nel byte sinistro di 
Ri. Il valore dal byte S del PAB è la lunghezza effettiva del record appena letto. 
Questo valore è usato insieme con VMER per ottenere il record dal suo buffer in VDP 
RAM, in un buffer in cui il programma può accedere direttamente (linee 39/43), Le 
linee 44/47 ottengono e visualizzano il primo none. Le linee 48/52 fanno la stessa 
cosa con l'ultimo nome. Il calcolo alla linea SI determina l'effettiva lunghezza del 
campo dell'ultimo nome, sottraendo la lunghezz del campo del primo none 
dall'effettiva lunghezza del record che fu trovato nel byte S del PAB. 

Alla fine del lavoro (linea 76) una decisione deve essere presa perchè in ogni 
caso il file necessita di essere chiuso. Per chiuderlo 1’O0P-CODE per "CLOSE" ()O1) 
viene scritto nel byte 0 del PAB e viene eseguito un altro accesso a DSRLNK. Poi il 
programma segue i precedenti esempi che attendono che venga premuto un tasto per 
finire. Ecco un programma in TI BASIC che creerà un nome del file simile a quelo 
usato come input al programma esempio nel linguaggio. ASSEMBLY. 


100 CALL CLEAR 

110 DPEN #2: "DSkK2.FILE1i",OUTPUT,VARIABLE 80 
120 INPUT “INSERIRE UN "E" GUANDO AVETE FINITO":X£ 
1350 IF X$="E" THEN 190 

140 INPUT "PRIMO NOME ?":PN#$ 

150 IF LEN(PN$)>14 THEN 140 

160 INPUT "ULTIMO NOME ?"*:UN#$ 

170 FRINT #2:PN$,UN$ 

1B0 GOTO 120 

190 CLOSE #2 

200 END 


Qui di seguito vi è una visualizzazione esadecimale del file creato dal programma 
in TI BASIC. @Guesto è stato prodotto con il dischetto "AIUTO ALLA PROGRAMMAZIONE II" 
una utility della TEXAS INSTR. Mentre il prograama in BASIC limita la dimensione del 
campo del primo nome ad un massimo di 14 caratteri, non c'è tale limite con le 
dimensioni dell’ultimo nome. Se vci intendete processare un file creato con il TI 
BASIC per mezzo dell'ASSEMBLY del TMS9900, è importante che il programma in TI BASIC 
sia codificato per specificare determinate posizioni di campi, e i campi lunghezza. 
Oppure come è stato fatto in questo caso, voi potete usare l'’utility DUMP dell’Aiuto 
alla Programmazione II, per svelare come i record del file appariranno nel prograama 
ASSEMBLY. 


7I 


IL TIFO DI FILE E DISFLAY 


IL TIFO DI RECORD E VARIABLE B0 


13 44 41 S6 (.DAV) 
49 44 20 20 (ID ) 
20 20 20 20 ( ) 
20 20 20 535 ( 9) 
54 4F 4E 45 (TONE) 
14 4D 41 52 (.MAR) 
vb 49 4E 20 (VIN ) 
20 20 20 20 ( ) 
20 20 20 S3 ( 9) 
50 41 52 46 (PARK) 
53 15 57 41 {S.WA) 
59 4E 45 20 (YNE ) 
20 20 20 20 ( ) 
20 20 20 20 ( ) 
4E 45 57 45 (NEWC) 
4F 4D 45 (OME ) 


Quando create file con i programmi in ASSEMBLY del TMS 5900, voi dovete designare 
la disposizione di ogni record. Voi decidete quanto può essere lungo ogni campo, e la 
sua posizione di inizio nel record. Una delle inefficienze del BASIC è che assegna lo 
spazio per le stringhe dentro un record in predeterminati blocchi di byte. A meno che 
voi non codifichiate il programma BASIC per strutturare ogni campo, il TI BASIC segue 
un algoritmo predederminato per la lunghezza del campo. 

Le stringhe alfanumeriche, per esempio, partono seapre con una lunghezza di 14 
byte. Nel caso del campo del primo nome, anche se tutti i primi nomi inseriti non 
sono Mai più lungi di 4 o 5 byte, vengono costruite stringhe di 14 byte per ognuno. 
Togliendo la linea 150, che restringe il carpo della lunghezza, se il primo nome 
inserito ha una lunghezza di iS byte, allora un blocco addizionale di 14 byte sarà 
aggiunto al primo. Così sarà creato uno spazio stringa per un blocco di 28 byte, 
quando sarebbe stato sufficente uno spazio per i5 byte. Questo diventa ancora peggio 
con stringhe numeriche. Anche se un numero di una sola cifra viene inserito, verrà 
creato un spazio per una stringa di 153 byte. 


Quando determinate i requisiti delle dimensioni del campo del record con 
l'ASSEMBLY del TM5S9900, voi potete E dovete fare un uso aolto più efficente dello 
spazio. Voi potete definire sia l'esatta posizione dì inizio e fine dei campi, sia 
dove sono necessari i campi di lunghezza variabile, voi potete usare un carattere 
speciale per separare i campi, o designare un byte che precede ogni campo per 
contenere la lunghezza del campo stesso. Per i numeri, se si conosce che avranno un 
valore compreso in una gamaa da l a 255, per eseapio, allora il valore può essere 
memorizzato come un'espressione binaria di un solo byte. 


Qualsiasi metodologia-che lavora per voi può essere valida purchè voi siate 
tenaci. Usate la vostra creatività e la flessibilità dell ASSEMBLY del TMS9900 per 
progettare file che rendono efficente l'utilizzazione dell’immagazzinamento e della 
memoria. Finchè i file di dati sono creati da voi per essere usati solo con altri 
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linguaggi ASSEMBLY del TMS9900, allora qualsiasi progetto sarà accettabile. Comunque, 
se voi intendete processare altri tipi di file, o rifornire i file da voi creati per 
altri tipi di programmi, allora voi dovete conoscere per quale specifica disposizione 
il file e record sono stati congegnati. Quando questa inforasazione non è disponibile, 
l’'utilty DUMP dall'Aiuto alla Programmazione II può essere di grande aiuto. Questa 
utilty è decisamente raccomandata sia come un'utile strumento, sia come una chiave per 
capire come i record e file sono creati dal TI BASIC. 


I file con record RELATIVE (ad accesso casuale) permettono l'accesso diretto a 
qualsiasi record sun file, senza che sia necessario leggere l’intero file, come nel 
caso di un file sequenziale. @uesta caratteristica non solo può essere usata per 
accedere casualmente ad un singolo record, ma può anche essere usata per posizionare 
la testina di lettura/scrittura del disk drive, su un particolare record. Foì voi 
leggerete sequenzialmente i record seguenti. I file con record relative possono anche 
essere letti dal primo all'ultimo, o dall'ultimo al primo sequenzialmente, altrettanto 
bene. Tutti i file con record relative devono utilizzare record con lunghezza FIXED 
(fissa). 1 byte 4 e S del PAE (Lunghezza del record, e contatore dei caratteri) 
dovrebbero essere uquali. 


La codificazione e l'istituzione del PAB e buffer per i file con record relative 
è identica a quella dell esempio precedente. Il progetto di una subroutine che esegua 
il DSR può essere esattaaente simile a quella dell'esempio sequenziale. Il tipo di 
accesso che voi potete esequire su un file relative dipende da come il file é stato 
aperto. INPUT vi permette solo di leggerlo. OUTFUT vi permette solo di scriverlo. 
UFDATE vi permetterà di leggere e scrivere. APPEND vi permetterà di aggiungere record 
alla fine del file precedentemente creato. 


Le chiavi dell'accesso casuale (relative), è la aanipolazione del nuaero dei 
record relative nei byte S e é del PAB. Se questi byte contengono tutti zeri alla 
vostra prima lettura, e fate letture successive senza alterare il numero del record 
relative, DSRLNK incrementerà questo valore per voi. Per conoscere quale record voi 
state per leggere o scrivere, ottenete il numero delì record relative dai byte 6 e 7 
del PAB prima di ogni DSRLNK. Ecco qui alcune istruzioni che fanno questo. 


RELREC BSS 2 Mette da parte spazio per i numeri 


LI RO,FABADR+6 Indirizzo nel PAB del numero dei 


* record relative 
LI RI ,RELREC 
LI R2,2 Lunghezza da leggere, due byte 
BLWP  @VMER Ottiene il numero 
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Nella stessa maniera, se voi desiderate leggere un record specifico da un file 
relative, voi dovete mettere il numero del record relative nei byte 6 e 7 del PAB, 
prima che il DSRLNK sia esequito. Le istruzioni sopra riportate faranno questo se voi 
sostituite VMBR con VMBW. Il risultato di provare a leggere un record relative che 
non esiste dovrebbe essere un errore di EDF (5) e DSRLNK chiuderà il file, 


DSR_ CASSETTE 


La routine DSR per le cassette è localizzata in GROM ed è una delle routine 
residenti GPL. Quando create file su cassette, devono essere osservate parecchie 
restrizioni. I file su cassette devono avere record di lunghezza fixed, e la loro 
lunghezza deve essere un multiplo di 64 (64, 128, o 192). 1 file su cassetta possono 
solo essere aperti come INFUT o OUTPUT. Con le cassette non esiste la rivelazione 
della fine del file (EOF). Voi dovete creare un record EOF come ultimo record su un 
file su cassetta, e codificare ogni programma che legge il file per rivelare qualunque 
EOF dei dati da voi creati, 73 


Fer accedere al DSR delle cassette o a qualsiasi altra routine 6FL, bisogna 
includere una REF GPLLNK nel vostro progranmaa, con 1lE/RA, o una direttiva EQU 
all'indirizzo >}6018 con qualche etichetta valida di due caratteri, con l'assenbler 
LINEA per LINEA. Usando la DSR delle cassette o qualsiasi altra routine GPL, la 
caratteristica partenza automatica (includendo l'indirizzo del punto di entrata con la 
direttiva END) non può essere usata, 


La grande differenza con il trattamento dei file da cassetta, è la stessa DSR 
cassette. Ricordate quando codificate i dati del PAB per i vostri file su cassette di 
usare il valore corretto per il byte 8 del PÀAB (offset dello schermo). Per un 
programma ASSEMELY autonomo , questo valore dovrebbe essere >00. Se il vostro 
programma in ASSEMBLY è chiamato dal BASIC, allora questo valore sarà >60. C'è qui un 
progranma di esempio che usa un file su cassette. @Guesto programma scrive 10 record 
su un dispositivo a cassette. In verità questo programma non crea nessun dato valido 
per ogni record. Esso è soltanto un esempio di accesso alla cassetta. 


01 REF GPLLNK,VSBW,VMEW,KSCAN 

02 STATUS ECU >B37C 

03 FAC EQU >E34A 

04 PABBUF EGU >1000 

05 PAB ECU >FB0 

06 PDATA DATA >0002,)1000,)B000,>0000,)0003 
07 DEV TEXT ’CSI 

08 RETURN BSS 2 

09 WR BSS - 20 

10 START MOV RI1,€@RETURN 

Ii LWPI WR 

12 LI RO, PAB Stabilisce il PAB 
13 LI RI,PDATA 

14 LI R2,14 

15 BLWP_ @VMBWH 

16 BL @DSRCAS Apre il file 

17 LI R1,)0300 Attiva la scrittura 
18 LI RO,PAB 
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19 BLWP_ €VSBW 


20 CLR R6 
21 CPUT BL @DSRCAS Scrive un record 
22 INC R6 Aggiunge uno al contatore record 
23 CI R6,10 Controlla per i0 record scritti 
24 JLE CPUT 
25 LI R1,20100 Attiva la chiusura del file 
26 LI RO,PAB 
27 BLWP  @VSBW 
28 BL @DSRCAS Chiude il file 
29 JMP_ EDI Vai alla fine del lavoro 
30 DSRCAS CLR@STATUS Pulisce il byte dello STATUS GPL 
31 CLR @>)85D0 Pulisce l'indirizzo >B3DO 
32 LI R3,3 
53 MOV R3,€)8354 Mette il valore 3 a )}B354 
34 MOV @DEV,EFAC Mette il nome dispositivo a FAC 
35 MOVB  @DEV+2,@FAC+2 
36 LI R3,)0800 
37 MOVB R3,€>836D Mette il valore 8 nel byte >B56D 
38 LI R3,PAB+13 
39 MOV R3,68356 Stabilisce il puntatatore al DSR 
40 BLWP  @EGPLLNK Esegue la DSR della cassetta 
41 DATA >0050D 
472 * 
43 RT Ritorna 
44 EOJ CLR = @STATUS Pulisce lo STATUS 
45 BLWUP  @KSCAN Attende che qualche tasto sia 
# premuto 
46 MOV @STATUS,ESTATUS 
47 JEL  EOJ 
48 CLR a @STATUS 
49 MOV @RETURN,lI 
50 RT Ritorna 
S1 END Downloaded from www.ti99iuc.it 


Il cuore di questo programaa esempio è la routine della DSR cassetta dalla linea 
30 alla linea 43. Il byte dello STATUS GPL e l'indirizzo )}B35D0 devono essere tutti a 
zero. Il nome del dispositivo ("CS1") deve essere messo all'indirizzo >B834A, e la 
lunghezz del nome del dispositivo (3) deve essere a )B354, >8355. Poi il valore 8 
deve essere messo nel byte all'indirizzo >8560D per indicare una chiamata DSR. Il 
puntatore all'indirizzo del PAB deve essere messo all'indirizzo >}8356, come negli 
altri esempi del DSR. Comunque, con il DSR delle cassette, il valore deve puntare al 
byte dopo il nome del dispositivo "CS1" (PAB+13). GBPLLNK è richiesto con 
un'istruzione BLWP, e necessita del valore >SD passato ad esso per coapletare 
l'istruzione. 

In questo programma esempio, l'apertura fa comparire il prompt "REWIND CASSETTE", 
La scrittura il prompt “PRESS CASSETTE RECORD", ed infine, la chiusura farà apparire 
il prompt “PRESS CASSETTE STOP”. 
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MANUALE DI RIFERIMENTO E/A 
I sequenti riferimenti vi forniranno altre informazioni sul trattamento dei file. 


Sezione 16-2-2 pag. 25l 

Sezione 16-2-4 pag. 262 

Dalla sezione 16-5 paga. 270, alla sezione 16-5-4 pag.271 
Dalla sezione 18-1 pag. 291 alla sezione 18-3 pag. 303 
Dalla sezione 24-12 pag. 443 alla sezione 24-12-4 pag. 444 


NOTE SULL'ACCESSO ALLE GRON 


1) L'accesso alle GROM/GRAM deve essere separato da almeno una istruzione per 
adattare le differenze dell'esecuzione hardware. 


2) L'’indirizzamento delle GROM è autoincrementante. Cioè, dopo ogni accesso 
all'indirizzo GROM, quest’ultimo viene automaticamente incrementato di 1 dal computer. 


3) Gli indirizzi GROM sono scritti nel primo byte più significativo. 


4) Cuando l'indirizzo di lettura GROM/GRAM (GRMRA) è letto, l'indirizzo GROM 
viene distrutto e deve essere ristabilito se richiesto dal progranaa. 


LEGGERE QUESTI TERMINI SUL GLOSSARIO 


Device service routine = (routine dispositivo di servizio) 

DSR 

File 

Field = (campi) 

GPL 

GROM 

Mode of operation = (modo di operazione) 

Feripheral Access Block = (blocco di accesso alle periferiche) 
PAB 


CAPITOLO DECIMO 
CLASSIFICAZIONE E TRATTAMENTO DEGLI ARRAY 


La sequenza dei dati in un prescritto ordine o “"SORTing" =. (Classificazione), è 
un primo esempio di trattamento della tavola. Un tema ricorrente in questo testo è il 
limite del TI BASIC in velocità ed esecuzione rispetto all'ASSEMBLY del TM59900, 
Forse nessun altro compito può illustrare meglio la sua velocità del SORTing. 
Viceversa il SORTing è uno dei migliori esempi sulle insufficenze del TI BASIC in 
termini di calcolo e velocità. 


Il SORTing è un compito che coinvolge una gran parte del conputer, perchè sono 
richieste un grande numero di azioni ripetitive. Ci sono molti sistemi di SORTing che 
cercano di limitare il numero di ripetizioni richieste per realizzare il SORT. 
Nessuno di questi sistemi richiede un trucco magico, ma fanno tutti assegnamento sul 
processore usato per elaborare rapidamente le azioni logiche richieste. 

Come aumenta il numero di record, così aumenta il tempo richiesto per 
classificarli. Foichè la velocità e l'esecuzione sono critiche per l'esecuzione del 
SORT, la scelta logica di un linquaggio per scrivere un programma di SORT è 
1 ‘ASSEMBLY. 


Non è intenzione di questa sezione insegnarvi tutto sopra la teoria del SORT, ma 
piuttosto di illustrarvi come un seaplice SORT può essere implementato usando il 
linguaggio ASSEMELY del TMS9900, e le varie istruzioni, subroutine, e metodologie 
finora impiegate. Se voi volete diventare bravi nello i programmi di SORT, e imparare 
alcuni dei vari metodi utilizzabili per il SORTing, vi sono molti libri dedicati ad 
esso. Alcuni di questi sono: 


Lorin Harold - SORTING AND SORT SYSTEMS 
Knuth D.E. - THE ART OF COMFUTER PROGRAMMING 
Flores Ivan - COMPUTER SORTING 


I) SORT del programma di questa sezione non usa nessuna istruzione o routine che 
non sia già stata descritta in precedenza. Alcune di queste routine, i cui nomi voi 
riconoscerete sono state migliorate rispetto agli esempi precedenti, o sono usate in 
nuove e differenti maniere. Cose come titoli di progranmei, prompt, grafici a colori, 
interazione con la tastiera, e trattamento dei file, sono tutti basati sugli esempi e 


le spiegazioni date nelle sezioni precedenti. Il presente SORT logico usato è 
piuttosto sommariamente confrontato ad alcune delle tecniche più avanzate che sono 
disponibili. GCuesto semplice sistema provvede ad un modello più facilmente 


comprensibile, e gira ancora abbastanza velocemente per naerito della velocità del 
microprocessore TMS9900. 


Il file dei dati da essere classificato è molto simile al nome del file del primo 
ed ultimo esempio della sezione precedente. Comunque per facilitare processi più 
veloci esso sarà un file relative con un record di lunghezza fixed di 80 byte. In 
computer più grandi, e con ben altre capacità di memoria, è possibile elaborare il 
maggior numero di file in qualsiasi formato, caricando i suoi dati in alcune aree di 
lavoro nella forma di una tavola, e manipolando i dati da li. Con il piccolo numero 
di record sul file esempio, questo metodo può essere usato con il computer casalingo. 
Il file nel formato relative, permette l'elaborazione di un file come se esso fosse 
già una tavola, e usa il dispositivo di memorizzazione. (disco) per memorizzare la 
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tavola piuttosto che la CPU RAM. 


Uno dei trucchi fondamentali di SORTing che sfugge a molti principianti, è che 
non si ha bisogno di fare il SORT di un'intero record di dati. Il solo dato che 
necessita di essere classificato, è quel dato che fa da chiave, per il campo o campi 
sui quali il file deve essere classificato. Cuesto provvede, naturalmente, che 
ciascuna di queste chiavi di SORT possano essere associate con il record al quale esso 
appartiene. 

Questo è il punto dove il numero del record relative (il quale può essere una 
tavola ad indice) entra in gioco. La premessa base di questo programma è quella di 
creare una tavola interna, ogni ingresso della quale è comprensivo della chiave di 
SORT, e numero del record relative di ogni record. Questi dati sono poi classificati 
nella sequenza desiderata. La tavola viene poi processata sequenzialaente per 
ottenere ogni record al posto del numero del record relative, e un nuovo file della 
sequenza di classificazione viene scritto. La capacità di memoria di un dischetto 
semplice faccia/semplice densità è di circa 90 Kbyte. Questo totale è molto maggiore 
di quella disponibile nella CPU, così è impossibile caricare tutti questi byte dei 
record nella memoria in una sola volta. Con questo tipo di programma di SORT 
comunque, affrontare un file così grande è fattibile. In un programma ASSEMBLY un 
numero di record memorizzato sotto forma binaria occupa una word o 2 byte. Se il 
dischetto contiene 358 record di 250 byte ognuno, e i dati della chiave di SORT per 
ogni record è lunga 20 byte, allora il totale della memoria necessaria per la tavola 
di SORT dvrebbe essere: (Chiave della lunghezza del SORT + Lunghezza del record 
relative) * Numero dei record, o, (20 + 2) # 358 = 7.676 byte. 


Alcuni sistemi di SORT permettono il SORT "in-place ?" del file originale. 
Cuesto programma crea invece un nuovo SORT del file, e preserva l'integrità del file 
originale, o Master. Un inconveniente del SORT "in-place" è che, se per qualche 
ragione, capita un errore nel processo, il file oriqinale può essere rovinato o 
perduto, se non era stata fatta una copia di back-up del file. Questo sistema 
permette anche ai dati originali dei file di esistere in molti differenti file, ognuno 
nella sua propria sequenza. Questo può essere utile quando è necessario processare 
gli stessi dati da più di una chiave di SORT. 


Ecco il programma completo del SORT 


_ 
—- —- cn _- nesso noi n 2 nonno - 
circeo sissi3:iir fesso sonoooncanocacsoneonececonseoeoo cooencoponsoococcoesscasscsiiztcea 


NOTA DEL TRADUTTORE: 
Anche questo programma, essendo abbastanza lungo, viene allegato a parte per 
facilitare il controllo con le spiegazioni delle linee del progranna stesso. 


ac cesesssoesoeceoeooooooooeroooooecooeoeoeooosoooooeoosoeocoesosooso=osoooososoooeesesosaoezz@_o_ =. 
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COMMENTI AL PROGRAMMA 


Con quasi 400 linee questo programma ASSEMELY TMS9900, può apparire complicato al 
principiante. Comunque, questo programma non è così complesso come il numero delle 
linee sembra indicare. In più, per eseguire il SORT loqico, questo prograama 
rappresenta un esempio di Quanto finora è stato gii discusso in questo testo. Esso 
include un numero di opzioni e caratteristiche, oltre al SORT, che aumenta 
considerevolmente la sua lunghezza. Di fatto l'effettiva gamma di istruzioni del SORT 
vanno‘dalla linea 147 alla linea 251, cioè solo circa il 28% dell'intero progransa. 
Il resto del programma è conpreso dalle istruzioni, direttive, e subroutine che sono 
state precedentemente spiegate. 

In ultimo, la chiave per comprendere qualsiasi programma che voi state qQquardando 
per la prima volta, è di esaminarlo linea per linea. È questo è vero sia per un 
programma lungo 5 o 5000 linee. Non siate intimiditi dalla lunghezza del prograana. 
Le sole sezioni di questo programma da essere spiegate dettagliatamente, sono quelle 
che useranno una nuova logica (il SORT) e nuove o migliori applicazioni delle 
istruzioni e subroutine introdotte in precedenza. 


Le linee da i fino a 59 usano le varie direttive assenbler del TMS9900, per 
definire le costanti, gli indirizzi, dati e aree di lavoro che il programma 
richiederà. I numeri dei Data includono un nuovo descrittore del pattern per il 
cursore, caratteri grafici da visualizzare sullo schermo, dati per il FAB dell'input e 
output dei file, e i titoli, prompt, e messaggi da essere visualizzati. La linea 59 
mette da parte 4096 byte (Hex >I1000) per lo spazio della tavola del SORT. @uesto è un 
valore arbitrario. Quando si progetta un programma di SORT o qualsiasi altra 
dimensione del programma interno del workspace, esso à necessario a permettere di 
prevedere alcuni o un massimo numero di record, e quindi, byte. 


Le linee da 60 a 75 salvano l'indirizzo di ritorno, caricano il puntatore al 
registro workspace, fissano i colori di backaround e foreground del caratere del 
bordo, e visualizza i caratteri, caricando infine i dati del pattern del cursore nella 
tavola descrittrice del pattern in VDP RAM. Tutti questi passi ed istruzioni sono già 
state usate prima neì precedenti programmi esempio. I colori usati in questo 
programma sono il bianco sul blù, per il set di caratteri visualizzabili, e rosso 
scuro per il bordo dello schermo. 


La linea 76 eseque un BL (Branch and Link) = (Diramati e allacciati) alla 
subroutine SCREEN. Questa subroutine caricherà il pattern del bordo dello schermo 
nella tavola immagine dello schermo, e scrive una linea di siaboli "=" tra la parte 
alta e bassa dello schermo. Questa funzione viene codificata come subroutine per 
permettere allo schermo grafico di essere ristabilito o rifatto a qualsiasi punto del 
programma senza dover ricodificare le istruzioni. 

Le linee da 79 a 90 visualizzano il titolo del programma e presentano il prompt 
per il nome del file/dispositivo per l'output del file da essere classificato. Mentre 
il nome File/dispositivo del file input difficilmente viene codificato dentro il 
programma, l'’@utente è libero di specificare l'output del file. Ffoichè il file output 
del SORT in questo programma esempio è un file relative, simile al file input, esso 
naturalmente deve essere su disco, I1 nome del file /dispositivo viene letto 
dall'indirizzo 195 dello schermo, dentro il file output del byte 10 del PAB. La 
lunghezza di questi dati è ritornata in R7 da CURSOR. f@uesto valore della lunghezza 
viene mosso al file output nei byte 8 e 9 del PAB per coanpletare i dati del file 
output. 
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Nel capitolo ottavo voi siete stati introdotti ad una routine fondamentale di 
input dalla tastiera, chiamata CURSOR, che provvedeva ad abilitare l’interratività 
dalla tastiera. Questa routine è di nuovo inclusa in questo programma. Questa 
versione di CURSOR include alcune Capacita aggiuntive che non esistevano 
nell'originale. Oltre che a usare un unico simbolo del pattern per il cursore, la 
nuova routine CURSOR lo fa anche lampeggiare. Due uscite addizionali sono permesse, 
all'utente. Se preme REDO = (rifare) la nuova routine CURSOR si dirama alla linea 76 
(PROMPT) per reinserire nuovamente il dato richiesto. Se l'utente preme QUIT, la 
routine si dirama alla linea 268, E0JQ. Diramandosi a questo indirizzo, si salta la 
chiusura dell'input e output dei file (che non sono ancora stati aperti), e si termina 
il programma. Fer ultimo, finchè la lunghezza della risposta specificata in RIO prima 
di BL a CURSOR è maggiore di zero, CURSOR non permetterà all'utente di premere 
semplicemente ENTER senza avere inserito alcuni dati. 


Le linee da 91 a 107 chiedono all'utente di specificare quale campo del file deve 
essere classificato. I prompt definiti alle linee 34, 535, e 36 permettono all'utente 
di inserire "i" per il primo nome, o "2" per l'ultimo nome. La risposta viene 
confrontata con il codice ASCII di questi due numeri, per verificare se è stata fatta 
una scelta valida. Se viene inserito un qualsiasi valore oltre a quelli permessi, la 
sequenza del prompt viene ripetuta. 

Questo ha lo stesso effetto di come se si premesse REDO. La sola altra opzione 
disponibile sarebbe @QUIT. Poi le linee da 108 a 1418 richiedono che l'utente 
specifichi l'ordine in cui i record devono essere classificati, La risposta "A"” 
indica che i file devono esere classificati nella sequenza Ascendente, mentre la 
risposta "D" significa che la classificazione deve essere fatta in ordine Discendente. 
Le risposte vengono verificate perchè siano effettivamente “A" o "D". Giunti a questo 
punto il programma ha chiesto all'utente di indicare il nome del file/dispositivo del 
file output da classificare, quale campo classificare, e se il SORT deve essere in 
ordine Ascendente o Discendente. 


Le linee da 119 a 123 chiedono all'utente di verificare le informazioni che sono 
state inserite, e rispondere premendo REDO o qualunque altro tasto. Se la risposta è 
ReDO, allora il CURSOR si dirama all'inizio della sequenza prompt per permettere ai 
dati di essere reinseriti. Se qualsiasi altro tasto viene premuto , allora il 
programma continua. Le linee da 124 a 136 ottengono e salvano il campo e le sequenze 
delle opzioni, stabiliscono il PAR del file input in VDP RAM, aprono il file input, ed 
attivano il file input da leggere. 


Le linee da 137 a 144 tolgono i pronpt e le risposte, ripeteno lo schermo 
grafico, e visualizzano l'intestazione per il contatore dei record che saranno presi, 
e visualizzati durante il] processo, Un altro contatore prenderà il numero dei record 
input (SORT in) e record output (SORT out). Questi due contatori dovranno essere 
sempre uguali, finchè il, programaa funziona bene, e non succedono errori. 


La prima fase del processo di SORT implica la lettura del file che deve essere 
classificato, e la costruzione di una tavola per il campo del SORT e numero del record 
relative per ogni record. Poichè sono impiegate molte ripetizioni delle word (16 bit) 
nel caricare la tavola per.eseguire il SORT effettivo, una subroutne chiamata MOVWRD è 
stata codificata proprio per questo scopo. Tutte le volte che lo stesso o similare 
gruppo di istruzioni necessita di essere eseguito più di una volta, è preferibile 
creare una subroutine comprendente il set di istruzioni, piuttosto che codificare le 
istruzioni stesse più e più volte ancora. 
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La routine MOVWRD usa i registri 6, 7, &, e 9 per muovere le word di memoria tra 
le varie locazioni in CFU RAM. Il registro 7 deve contenere l'indirizzo di origine, 
il registro 8 l'indirizzo di destinazione, ed il registro ?, la lunghezza del 
movimento in byte (sempre un numero pari di word mosse), ed infine, il registro 6 è 
usato per i calcoli. 


La linea 144 carica R8 con l'indirizzo di destinazione (area della tavola del 
SORT, SRTTAB). La linea 145 mette la lunghezza dei dati in R9. Le linee da 162 a 167 
mettono l'’indirizz di origine in R7, dipendendo da quale campo è stato selezionato 
per essere classificato. La lunghezza del campo di SORT è fissata in 14 (DE) per 
ciascun campo. Questa è la massima lunghezza del primo campo del nome , come definito 
dal programma TI BASIC che lo ha creato. La lunghezza effettiva del campo dell'ultimo 
nome è variabile. La lunghezza-del campo di SORT deteraina il numero dei byte che 
devono essere confrontati per rivelare quei record che sono fuori dalla sequenza. 

Più grande è questo numero, e più tempo occorrerà’ per fare il SORT. Una 
scorciatoia può essere presa facendo un SORT logico solo per un dato numero di byte 
senza badare alla lunghezza del campo di SORT. Foichè è improbabile che qualsiasi 
record contenga un ultimo nome maggiore di 14 byte, è ancora più improbabile che i due 
ultimi nomì contengano gli stessi caratteri fino alla quindicesima posizione, questo 
metodo è ragionevolmente accurato, e risparmia del tempo. La lunghezza del valore 
potrebbe essere minore o maggiore, ma troppa differenza potrebbe essere inesatta, © 
richiedere più tempo. L'effettivo numero dei byte che voi scegliete per confrontare è 
soggettiva, ma è possibile barare un poco. 

Fer dimostrare come opera un SORT logico in questo prograama, è necessario fare 
alcune ipotesi circa quali opzioni sono state selezionate, e provvedere ad alcuni dati 
per il processo del programma. Per il resto di questa spiegazione si presume che 
l'utente abbia bisogno di classificare il file di input sull'ultimo campo del nome, e 
abbia bisogno di classiticare il file in ordine Ascendente. Ecco qui un file input di 
10 record. 


RECORD FRIMO ULTIMO 
RELATIVE N°. NOME NOME 
0000 JIM SMITH 
0001 EOB JONES 
0002 MARY QUEENS 
0003 MARVIN STONE 
0004 LINDA BLACKSMITH 
0005 GEORGE HASHINGTON 
0006 THOMAS JEFFERSON 
0007 WILLIAM MCKINLEY 
0008 HOWARD TAFT 
0009 HOWARD JOHNSON 


Come voi potete vedere, questi record non sono in un ordine particolare. Le 
linee da 147 a 170 leggono il file e costruiscono la tavola del SORT. Ogni entrata 
della tavola è composta dai primi 14 byte dell'ultimo campo del nome, più 2 byte per 
il numero del record relative di ogni record, per un totale di una lunghezza di lé 
byte. Cuando viene raggiunta la fine della tavola, la linea 171 muove una word 
contenente >FFFF al prossiao indirizzo della tavola allo scopo di segnare la fine 
della tavola. La subroutine MOVWRD che viene usata per creare una tavola, illustra 
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l’uso di un modo di indirizzamento conosciuto come “WORKSFACE REGISTER INDIRECT 
AUTO-INCREMENT" = (Registro HWorkspace indiretto ad autoincremento). La linea 216 
MOVEM #R7+,#*R8+ specifica che il valore in ogni registro deve essere usato come 
indirizzo, e che dopo ogni movimento il valore nei registri sarà automaticamente 
incrementato. Questa utile caratteristica di indirizzamento, incrementa i registri 
implicati di i per le istruzioni byte, e di 2 per le word. Dopo che il file è stato 
letto, e la tavola di SORT creata, la tavola SORT dovyrebbe apparire come sotto. 
Notate che gli effettivi valori nella tavola del SORT sono codici ASCII per le 
lettere, ed espressioni binarie per i numeri dei record relative. L'esempio ‘è qui 
mostrato nel formato display. 


INDIRIZZO CONTENUTO DELLA TAVOLA 
SRTTAB+0 SMITH 00 
SRTTAB+16 JONES 01 
SRTTAB+32 QUEENS 02 
SRTTAB+48 STONE 03 
SRTTAE+64 BLACKSMITH = 04 
SRTTAB+B0 MASHINGTON 05 
SRTTAB+96 JEFFERSON 06 
SRTTAB+112 MCKINLEY 07 
SRTTAB+128 TAFT 08 
SRTTAB+144 JOHNSON 09 
SRTTAE+160 >FFFF 


La seconda fase di questo processo di classiticazione (SORT), è di predisporre le 
entrate della tavola nell'ordine desiderato. Fer fare questo, il programma parte con 
la prima entrata nella tavola, e confronta ogni byte dei dati della chiave di SORT con 
quello della prossima entrata della tavola. Se i dati della chiave di SORT delle due 
posizioni della tavola, confrontati fra loro, sono già nella giusta sequenza, o se 
sono uguali, allora non è richiesta nessuna azione, e il confronto si sposta alla 
prossima copia di entrate della tavola. 

Fer rendere facile mantenere la relazione delle entrate, da confrontare 
direttamente, la prima entrata della tavola sarà riferita come "A", e la prossima 
entrata come "B". Fer l’esempio di sequenza Ascendente, tutte le volte che "A" è 
riconosciuto come maggiore di "BE", le loro posizioni nella tavola verranno invertite. 


Le linee da 180 a 185 calcolano l'indirizzo della copia di entrate della tavola 
da essere confrontate. L'indirizzo di "A" viene salvato in RO, mentre "B" è salvato 
in RI. Le linee iB6, 187 esaminano l'indicatore di fine della tavola, Se la fine 
della tavola è stata raggiunta, allora questa fase del SORT è stata fatta, e la linea 
187 dirige il programma all'indirizzo "DONE2". La prima volta per mezzo di questa 
logica, R3 è caricato con l'indirizzo SRTTAB, e RA4 è caricato con l'indirizzo 
SRTTAB+16. R2 conterrà il valore dell'indirizzo dell'ultimo byte della parte della 
chiave SORT dell'entrata della tavola. 

Se R2 è uguale a R3 alla linea 192, allora tutti i byte della chiave di SORT sono 
stati confrontati, ed è tempo di muovere alla prossima copia di entrate della tavola. 
Le linee 190 e 191i controllano l'opzione dell'ordine, confrontando ancora l'opzione 
con >44 (ASCII di "D"). Se è stato selezionato l'ordine discendente, allora viene 
eseguito il confronto con il ciclo CLOPD. Altrimenti, il default è l'ordine 
ascendente, il quale eseque il confronto con il ciclo CLOP. Ecco uno scheaa del primo 
confronto. 


82 


0194 CB +R3+,#R4+ 


0195 JEL CLOP 
0196 JGT SKkIT 
INDIRIZZO NEL VALORE DELL’ 
REGISTRO 3 INDIRIZZO 
Downloaded from www. ti99iuc.it 
SRTTAB+0 )53 0 "S* 
INDIRIZZO NEL VALORE DELL’ 
REGISTRO 4 INDIRIZZO 
SRTTAB+16 54h 0 "J" 
L'istruzione CB compara byte = (confronta i byte) è usata perchè il confronto 


deve essere fatto su un carattere dal carattere base, ed il carattere prende un byte. 
Il valore all'indirizzo in R3 ("5") è maggiore del valore all'indirizzo in R4 (“JI”). 
Cuesto confronto fissa il bit "maggiore di" del registro di status. Questa condizione 
è controllata e l'azione risultante è diretta alla linea 19%. Essa sarà necessaria 
per scambiare le posizioni delle due entrate delle tavole. Usando le nominate 
convenzioni "A", e "B", la tavola di entrata per SMITH è "A", e JONES sarà “B". Ecco 
tre passi per il processo di inversione. 


i 
"A® |SMITH 001 
lio — rss spl 


I I | 
“"B® |JONES gl|-------—-- >"HLDTAB" |JONES oli 
| Ì I I 





Move “A” to “B”. 





| | 
"A" |SMITH 00| 





I I 
——-—__ 
I 
Vv 
| I | 
“B° |SMITH 001 "HLDTAB® |JONES gli 


Î STAT RSA A 
Move TABHLD (‘B') to “A” 








I | I I 
"A" |JONES 01|<---------- "HLDTAB" |JONES ali 


I I I I 
| I 
“"B" |SMITH 001 
I 
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Queste sono le istruzioni che esequono l'inversione logica. 


203 SWIT MOV R1,R7 Carica R7 con l'indirizzo "B" 
204 LI RE,HLDTAB Carica RB con l'indirizzo KHLDTAB 
205 MOV EeTABLEN,R9 Carica R5 con la lunghezza da muovere 
206 BL @MOVWRD Muove "BE" per occupare l'area 
207 MOV RO,R7 Carica l'indirizzo di "A" 
208 MOV R1,R8 Carica l'indirizzo di "EB" 
209 BL EMOVWRD Muove "A" a “B" 
210 LI FR7,HLDTAB Carica l'indirizzo da occupare 
211 MOV RO,RB Carica l'indirizzo di "A" 
212 BL @MOVWRD 
215 JMP COMPAR Controlla ancora la sequenza della 
* tavola 
214 MOVWURD MOV R9,R6 Carica la lunghezza da muovere 
215 À R7,R6 Calcola il massimo indirizzo 
216 MOVEM MOV *R7+,*RB+ Muove la word, e increa. l'indirizzo 
217 C R7,R6 Controlla il masssimo indirizzo 
218 JINE MDVEM Se non è massimo, muovi ancora 
219 RT Altrimenti ritorna 


La linea 2f5 ritorna all'etichetta COMFAR dopo che l'inversione è stata fatta. 
Ogni volta che una coppia di entrate della tavola non sono trovate in ordine, e 
vengono invertite, il confronto logico ricosincia dall'inizio della tavola. Guesto 
viene fatto più e più volte finchè tutte le entrate delle tavole sono nell'ordine 
corretto. Se tutte le entrate sono già nell'ordine corretto, non ci sarà mai una 
condizione che farà eseguire la inversione logica, e la fine della tavola è raggiunta. 
Il tipo di algoritmo del SORT applicato alla tavola, è conosciuto come "EUBBLE"”. Ogni 
voce nella tavola viene mossa alla posizione che gli appartiene. Voi potrete trovare 
molti programmi differenti che vengono tutti chiamati BUBBLE SORT. Le loro specifiche 
variano, ma il metodo generale è lo stesso. @luando questa seconda fase del prograana 
di SORT è conpletata, la tavola del SORT assomiglierà a questa. 





SRTTAB+0 = IBLACKSMITH 041 


I 
SRTTAB+16 |JEFFERSON 061 


SATTA. onto 69 
SRTTAB+48 Jones —’— gii 
semmai da) 
SRITAB+88  JousenS I 
srrtas+96 Isuiza  — — d0! 
sammABAtia:" [sro dal 
cai a ni 


SRTTAB+144 |WASHINGTON 95] 
I 

SRTTAB+160 |>FFFF | 
| 
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La terza fase implica la lettura della tavola sequenzialmente, usando i numeri 
dei record relative per richiamare casualmente i record dal file input, e scriverli 
nel file output. 


Le linee da 220 a 25355 preparano la terza fase, stabilendo i PAB per i file input 
e output, aprendo i file. input e output, e fissando 1l'OF-CODE per leggere il file 
input, e 1’OP-CODE per scrivere il file output. Nella fase uno il file input era 
stato letto fino alla fine del file, ed era stato chiuso dalla routine DSR. Ora deve 
essere letto ancora, così i dati del FAB sono ristabiliti, ed il file riaperto. 


La linea 234 carica l'indirizzo iniziale della tavola per il primo numero dell’ 
entrata del record relativo in RB. Le linee da 255 a 238 controllano il FLAG = 
(indicatore) della fine della tavola, ogni volta per mezzo del ciclo GETRR. Le linee 
da 2359 a 243 ottengono ìil numero del record relativo dalla tavola, lo mettono nel PÀAB 
byte è e 7 del file input, e leggono questo record dal file. 1 dati per il PAÀB per il 
file input, nominano l’area del VDF RAM, RECBUF come lo spazio buffer in cui ogni 
operazione di lettura mette un record del file input. I dati del FAB per il file 
output usa la stessa area buffer come il posto dove ogni operazione di scrittura sì 
aspetta di trovare il record da scrivere, Nessun'altra manipolazione dei dati del 
record è richiesta, 

Ecco lo schema del primo ciclo GETRR. 


Ottiene (legge) il numero del record trovato all'indirizzo in R8 dal file input 
nel RECBUF. 








REGISTER 8 SRTTAB INPUT FILE 
|=---] I | 
SRTTAB+14 +14 | 094 | 100 JIM SMITH | 
]o-=-]  1|-_------------------------.--- I 
+39 | 061 191 BOB JONES 
eseec| K |s.cenessnssoesscsocssrs,;};ssccsszsez sano | 
+46 | 09 | 102 MARY QUEENS | 
I | I-------------—----------_._... I 
103 MARVIN STONE | 
104 LINDA BLACKSMITH | 
IT TNI-_—_-------------------______- | 
| |05 GEORGE WASHINGTON I 
v | 
I I 
RECBUEF | LINDA BLACKSMITH | 
Pa 


Write an output file record from RECBUF. 


| 

RECBUF {LINDA BLACKSMITH | 
OUTPUT FILE 

| 


I I I 
silicio --> |99 LINDA BLACKSMITH | 
: I 
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Addiziona il valore a TABLEN (16, Hex 210) a R$, e ripete il ciclo. 11 registro 
8 ora contiene SRTTAB+30. 


Cuesto processo continua finchè non viene raggiunto il segnalatore (Flag) di fine 
della tavola, ed a quel momento il programma logico si trasferisce a EOJ. Il 
messaggio "END OF JOB" = (fine del lavoro) viene allora visualizzato, ed il fle è 
chiuso. Il messagio "PRESS ANY KEY TO CONTINUE" = (premi un tasto per continuare), e 
un BL a CURSOR permette una pausa prima di finire effettivamente il programma. Con la 
possibilità di REDO di questa versione di CURSOR, l'utente a questo punto può 
scegliere di ripetere l'intero programma di SORT, o premere qualsiasi altro tasto per 
finire il processo, 


Alla fine del programma il file input esiste nel suo stato originale, ed un nuovo 
file output del SORT è stato creato. 


FILE INPUT FILE OUTFUT 
RECORD PRIMO SECONDO RECORD PRIMO SECONDO 
Relativo Nome None Relativo None Noae 
0000 JIM SMITH 0000 LINDA BLACKSMITH 
0001 EOB JONES 0001 THOMAS JEFFERSON 
0002 MARY QUEENS 0002 HOWARD JOHNSON 
0003 MARVIN STONE 0003 BOB JONES 
0004 LINDA BLACKSMITH 0004 WILLIAM MCKINLEY 
0005 GEORGE WASHINGTON 0005 MARY QUEENS 
0006 THOMAS JEFFERSON 0006 JIM SMITH 
0007 WILLIAM MCKINLEY 0007 MARVIN STONE 
0608 HOWARD TAFT 0008 HOWARD TAFT 
0009 HOWARD JOHNSON 0009 GEORGE WASHINGTON 


La maniera in cui i requisiti input/output dei due file sono indirizzati, dimostra un modo 
in cui il DSR può venire applicato. Nella sezione del trattamento dei file, era 
stabilito che tutte le richieste DSR sono trattate alla stessa maniera, per qualsiasi 
dispositivo, eccetto le cassette, e la sola differenza erano i particolari dati del 
file (PAB) puntato, e le operazioni (op-code) richieste. Nella routine DSR di cui 
sopra, la sola differenza tra l'accesso al file input e quello output sono le linee 
351, 352, e 353, che fissano il puntatore per il FAB (descrizione del file) usato. 
Gli op-code individuali per leggere, scrivere, e chiudere furono cambiati dentro il 
corpo del progranma. Le istruzioni rimanenti lavorano per l'uno o l’altro file. 
Dovendo rivelare un errore, il puntatore all'indirizzo in Ré può essere usato per 
calcolare l'’indirizzo del byte I del PAB (il codice di errore), ed il byte 10 del PAB 
(il descrittore del file "DSKi.FILE1") se il file output stava per essere scritto su 
un dispositivo a cassetta, questo metodo non lavorerà. Il DSK delle cassette deve 
essere accessibile da un differente set di istruzioni indicato nel capitolo del 
trattamento dei file, 


La subroutine CURSOR come è codificata in questo progranma di esempio, è una 
versione migliorata della prima introdotto. Questa versione opera in emaniera seolto 
simile all'originale. La differenza più notevole è il lampeggiare del cursore, Le 
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linee da 279 a 288 scrivono uno spazio (Hex >20) sullo schermo, e contano fino a 2.976 
(Hex >OBA0) per quattro. Una volta che il ciclo CURLI ha raggiunto questo valore, le 
linee da 289 a 257 visualizzano allora il simbolo del cursore. ll ciclo CURL2 conta 
fino a 2.976 per uno. flcune indicazioni della velocità del linguaggio ASSEMBLY del 
TMS9900 viene evidenziata dal fatto che tutto questo conteggio venga fatto nello 
spazio di un lampeggio del cursore. Contando per quattro mentre lo spazio è 
visualizzato (), e contando per uno quando è visualizzato il cursore, Significa che 
per 1’‘80% del tempo viene visto il cursore, e per il 20% del tempo, lo spazio. 

Voi potete anche alterare il ritmo del lampeggio, canbiando il valore a BLINK, o 
cambiando il valore di incremento per CURLI o CURL2. L'utilità di scansione della 
tastiera viene eseguita dentro il primo ciclo, così la risposta alla pressione di un 
tasto non sarà troppo lenta. 


Le linee da 298 a 301 controllano per i valori di REDO e QUIT, e dirigono di 
conseguenza il programma. @uando l'effettiva lunghezza del dato inserito è calcolata 
alla linea 352, il bit di uquaglianza del registro di status sarà fissato a uno, se il 
risultato in R7 è zero. Se un valore permesso di zero era messo in RIO, prima che la 
routine logica di CURSOR fosse eseguita, allora le linee da 329 a 354 non saranno 
raggiunte. Comunque, se il CURSOR raggiunge l'etichetta ENTER, un valore maggiore di 
zero dovrà essere stato specificato. La linea 355 controlla per il valore in R7, e se 
esso è zero, l'intera subroutine di CURSOR viene ripetuta. 
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CAPITOLO UNDICESIMO 
UNIRE L'ASSEMBLY CON IL BASIC 


E possibile creare sottoprogrammi in linguaggio ASSEMBLY che possono essere 
chiamati dai vostri programmi in BASIC o EX/BASIC. Questo risulta un progranaasa 
"ibrido" che offre il meglio di entrambi i linguaggi. I compiti del prograama possono 
essere compiuti con adequata efficenza in BASIC, e potrà essere poi codificato e 
“spulciato”, (cioè corretto) facilmente con questo linguaggio. 

I compiti che richiedono un miglioramento della velocità e esecuzione, 0 compiti 
che sono semplicemente impossibili da eseguire in BASIC, possono essere codificati in 
ASSEMBLY. Entrambi i moduli E/A o M/M provvedono ad aggiungere delle istruzioni 
supplementari per l’uso con programai in BASIC. Queste istruzioni facilitano 
l'allacciamento delle routine ASSEMBLY con i programai in BASIC. Allo stesso aodo 
1'EX/BASIC offre altre istruzioni per facilitare queste funzioni che non sono 
normalmente disponibili in TI BASIC. @uando voi state girando un programaa ASSEMBLY 
con l’E/A o la M/M, la memoria del computer non è disposta esattamente allc stesso 
modo come quando voi operate in BASIC o EX/EASIC. Allo scopo di far funzionare 
correttamente i vostri programmi ASSEMBLY, in ambiente BASIC, dovrete conoscere alcune 
differenze specifiche tra i due linguaggi. 


Primo, voi dovrete conoscere in quale ambiente BASIC il vostro prograana opererà. 
Di primaria considerazione per il programmatore ASSEMBLY sono le differenze trovate in 
VDP RAM. Il programma ERSIC e tutti i suoi dati, routine, e workspace occupano una 
buona parte di questa area. Il vostro programma ASSEMBLY non deve cambiare i valori 
di qualsiasi indirizzo usato dal BASIC. Certi valori delle tavole in VDP RAM, come la 
Tavola del colore, sono locate a differenti indirizzi in BASIC. 


Inoltre, il vostro programma ASSEMBLY deve permettere un offset (differenza) 
dello schermo quando gira con il BASIC. Il valore di questo offset è sempre di >60 
(Dec. 96). Qualsiasi carattere che desiderate visualizzare con il vostro prograama 
ASSEMELY deve avere il valore del codice del carattere aumentato di >60 Normalmente, 
per visualizzare una "A" sullo scherao, il codice del carattere è >41. In anbiente 
BASIC, comunque, questo valore deve essere aggiustato 


LI R0,293 Carica RO con l'indirizzo dello schermo in VDP RAM 
LI R1,)4100 Carica RI con il codice di "A" 

AI R1,>6000 Aggiusta per il BASIC 

ELWP @VSBW Visualizza la lettera "A" 


Per le costanti di stringa come quelle create con la direttiva TEXT ogni byte 


della stringa deve essere aggiustato aggiungendo >é60 prima di scriverla all'indirizzo 
della Tavola Immagine dello Schermo (TIS). 
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Ecco un semplice programma dal capitolo ottavo. Questa versione incorpora 
cambiamenti necessari perchè questo programma ASSEMBLY sia chiamato dal BASIC, 


DEF 

REF 
WR BSS 
STATUS EQU 
KEYVAL EGU 
DTEN DATA 


60 

VUTR,VSEW, VMEW,KSCAN 
>20 

>837C 

>8375 

>A 


# Tutti i codicì del carattere spazio (>20) sono stati incrementati 


* di >60 
BORDER DATA >FFFF,>8080,>B080,>B080 
DATA >BO0B0,>B080,>8050,>B080 
DATA >EOB80,>8080,>8080,>B080 
DATA ?>B0B0,>8080,>B080,>FFFF 
MSGI TEXT ’## PRESS ANY KEY #4” 
MS62 TEXT ’#* KEYSTROKE VALUE IS #'’ 
MSG3 TEXT ’# PRESS REDO/ESCAFE +’ 
* Offset della costante per il BASIC 
OFFST BYTE >60 
HH t+c+-4H HH H HH HH4H HH 4a4144H41441H4H4H4431H3H(414H4(445 44-40 43445444343H444HH(4H4(H((4HH4H(H5 4H1(5  34.Hda 44Hda 4453434445343414534434À44 3 
REDOV EYTE >06 
ESCV BYTE >OF 
EVEN Forza una word pari nel contatore di locazione 
SAVII BSS 2 
60 MOV RI1,€@SAVII 
LWPI WR 
LI R0,)0755 
BLUP EVUTR 
sessione 3tf& 


# Gli indirizzi usati in queste istruzioni per accedere alla tavola 
* del colore in VDP RAM sono stati aggiustati per il BASIC. 


LI 
LI 
BLWP 
LI 


R0,799 


R1,)5500 


@VSBW 


R0,780 


B9 


LI R1,21F00 
CLOOP ELWP EVSEW 


CI R0.798 
JEQ EPUT 
INC RO 
JMP _CLOOP 

BPUT LI RO,0 
LI RI,EORDER 
LI R2,32 

BLOOP BLWP E&VMBW 
CI R0,756 
JEQ EXIT 
AI RO, 32 
JMP BLODP 

EXIT LI R0,261 Indirizzo VDP RAM per il primo messaggio 
LI R2,MSGI Indirizzo del messaggio in CPU RAM 
LI R35,22 Lunghezza del messaggio 
BL EFBASIC Stampa il messaggio 

SCANI CLR ESTATUS 
BLWP @KSCAN 
MOVER ESTATUS,ESTATUS 
JEG SCANI 
LI R0O,325 Indirizzo VDP RAM per il secondo indirizzo 
LI R2,MSG62 Indirizzo del messaggio in CPU RAM 
LI R3,2 lunghezza del messaggio 
BL @FEASIC Stampa il messaggio 
LI R0,395 
MOVB EKEYVAL,RI 

siti: ncospsosoonsronrcroronsoscorscia 


# Il valore del tasto premuto deve essere aggiustato di >60 prima che 
# sia visualizzato 


AB @0FFST,RI 


BLWP @VSBW 
CLR RA 

MOVB @KEYVAL,R4 
SRL R4,8 

LI R3,404 

LI R0,406 

BL @FIGUR 


LI R0,485 Indirizzo VDP RAM per il terzo aessaggio 
LI R2,MSG63 Indirizzo del messaggio in CPU RAM 

LI R3,22 Lunghezza del messaggio 

BL @EPBASIC Stampa il messaggio 


90 


SCAN2 


FIGUR 


ESTATUS 
@KSCAN 
@STATUS, ESTATUS 
SCAN2 
@KEYVAL, @ESCV 
SCAN2 

@BPUT 

R4,RS 

R4 

EDTEN,RA4 
R5,)0030 

R5,8 

RS,RI 


# Il numero ASCII deve essere aggiustato di >60 prima di venire 


* visualizzato 


AB 


@OFFST,RI 
BLWF €VSBW 
DEC RO 
C RO,R3 
JHE FIGUR 
RT 
ESCAP CLR ESTATUS 
MOV ESAVIL,RIL 
RT 


* La routine “PEASIC" addiziona l’offset per il BASIC ad ogni byte 
* dei dati da visualizzare, e scrive un byte alla volta sullo schermo 


FBASIC MOVB #R2+,R1 Muove un byte del messaggio, in RI 
AB @0FFST,R1 Aggiusta per il BASIC 
BLWP EVSBEW Scrive un byte 
DEC RS Decrementa il contatore dei caratteri 
JINE PBASIC Se non è zero, ricomincia ancora 
RT 
END 


Ora per chiamare questa routine da un programma BASIC, voi dovreste 
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scrivere un programaa in questo formato. 


10 REM PROGRAMMA IN BASIC PER CHIAMARE 
20 REM IL PROGRAMMA DEL CAPITOLO OTTAVO 
30 REM IN LINGUAGGIO ASSEMBLY 

40 CALL INIT 

50 CALL LOAD(*DSKI.OBJECT") 

60 CALL LINK("60") 

70 CALL SCREEN(4) 

B0 FOR LO0O0P=780 TO 799 

90 CALL POKEV(LO00P,19) 

100 NEXT LOOP 

110 GOTO 60 


Per gli utenti della M/M che hanno già assemblato il programma, neaorizzato e 
addizionato nel modulo il nome del progranaa ed il punto di entrata per la tavola 
REF/DEF, l'istruzione LOAD della linea 50 non è necessaria. CALL INIT inizializza la 
memoria, pulisce i programmi e dati caricati in precedenza e controlla per vedere se 
l'espansione di memoria è collegata, e se è così, inizializza i valori necessari per 
allacciarla alla memoria della consolle per usare il linguaggio ASSEMBLY. CALL INIT 
deve apparire nel vostro programma PRIMA del primo CALL LOAD. 


CALL LOAD carica il codice oggetto dal file name del dispositivo specificato. 
Esso può anche essere usato per mettere (0 “"poke") i valori nella CFU RAM nel formato 
CALL LOAD (Indirizzo,Valorei,Valore2,Valore5...). CALL LINK si dirama all'indirizzo 
del punto di entrata del programma in linguaggio ASSEMBLY. Il controllo a questo 
punto viene passato al sottoprogramma. L'esecuzione delle rimanenti istruzioni in 


BASIC non continuano finchè il programma ASSEMBLY non ha conpletato il suo incarico e 
ritorna. 


Il programma ASSEMELY di questo esempio, compone lo scherao e il colore dei 
caratteri come bianchi su fondo blu. Ritornando dal sottoprogranma , il progranna 
EASIC rimette lo schermo ed il colore dei caratteri cone neri su fondo verde. 


In più usando CALL LOAD per aettere i valori nella CFU RAM, in TI BASIC sono 
disponibili altre utili istruzioni con 1'E/A e M/M. 

CALL PEEK (Indirizzo,Variabilel,Variabile2,Variabile3,...) vi permette di 
recuperare uno O più valori da un'’indirizzo in CPU RAM. Similarmente CALL PEEKV 
(Indirizzo,Valorel,Valore2,Valorei3,...) recupera un valore dal VDP RAM. CALL POKEV 
(Indirizzo,Valorel,Valore2,Valore3,...) mette uno o più valori in un'’indirizzo nella 
VDP RAM. 


Il formato per ciascuna di queste istruzioni è lo stesso. 1 valori sono 
memorizzati nel formato decimale. Indirizzi maggiori di 32.767 sono espressi come 
negativi in notazione di complemento a due. Ciascuna variabile o valore indica un 
dato di un byte. Quando viene usato più di un valore o variabile, il primo è 
assegnato al byte all'indirizzo specificato, e ciascun valore o variabile successiva 
viene assegnato dal prossimo byte al prossimo indirizzo. 


L'istruzione POKEV rimette i valori dei colori di priao piano e di sfondo della 
tavola dei colori del programma esempio di cui sopra, come nero su verde. Ogni byte 


92 


nella tavola del colore è fissato a >13 o dec. 19. Con la vostra conoscenza delle 
tavole e indirizzi, usando POKE e PEEK nei vostri programai EASIC potrete eseguire 
certi incarichi più velocemente che con le normali istruzioni BASIC, e fare anche cose 
normalmente impossibili col BASIC. Ricordate che l'offset dello schermo, di >60 (dec, 
96) riguarda anche queste istruzioni. fer esempio, CALL POKE (2,161) visualizza una 
"A" alla riga 1 e colonna 3. Sebbene il normale codice ASCII di "A" sia 65, 
aggiungendo ad esso l'offset di 96, si ha appunto lél (96+65). 


I byte >837D, >837E, >837F in CPU RAM sono parte di un’area conosciuta coae 
CPU RAM PAD. Questi indirizzi creano il buffer caratteri in VDP. Mettendo il codice 
del valore del carattere a 837D, il carattere sarà visualizzato sullo schermo alla 
riga e colonna specificata a >837E, e >}837F rispettivamente. Foichè l'indirizzo )837D 
(dec. 33661) è maggiore di 32.767, l'indirizzo deve essere dato nella notazione in 
complemento a due. Inoltre, questi indirizzi sono in CFU RAM e possono essere 
accessibili con CALL LOAD. In questa maniera, alcuni accessi al VDP potranno essere 
ottenuti senza usare FOKEV, il quale non è disponibile in EX-BASIC. CALL LOAD 
(-51875,161,1,3) visualizza una "A" alla riga 1 e colonna 3, proprio come ha fatto 
POKEV nell'esempio più sopra. Il primo valore (lél) è messo all'indirizzo }8237D (dec. 
-31875), il secondo valore (1) viene messo all'indirizzo 2837E (dec. -31874), ed il 
terzo valore (3) è messo all'indirizzo >8B37F (dec. -31873), 


L'AMBIENTE EXTENDED BASIC 


Esistono delle differenze su come un programma ASSEMBLY può essere usato con 
1'EX-BASIC in confronto al BASIC. Particolarmente, l’uso del VDP RAM varia sia 
rispetto al BASIC, sia rispetto al modo ASSEMBLY. Inoltre, in CPU RAM, l'area 
occupata dal'unità di espansione della memoria, può essere usata dall’'EX-BASIC, Gli 
indirizzi da >2000 a >SFfF, e da 2A000 a >FFEO sono usati dal caricatore (LOADER) 
dell'EX-BASIC. I programai in linguaggio ASSEMBLY possono essere solo più lunghi di 
Bkbyte dell'EX-EASIC. 


UTILIZZAZIONE VDP RAM 
IN MODO EX-BASIC 


INDIRIZZI 
HEX DECIMALI 
s0000 0 Tavola 
. Inmagine 
YOZFF. 767 Scheraoa 
>)0300 768 Lista 
Attributi 
>O3FF 1023 Sprite 
»0400 1024 Descrizione 
Pattern 
e Tavola 
Descrizione 
>077F 1343 Sprite 


207B0 1920 Tavola 
Movimento 
)07FF 2047 Sprite 
»0800 2048 Tavola 
>OBIF 2079 Colore 
>0820 20B0 Interprete 
Frogrammi 
Ex-Basic, 


Area lavoro, 
Tavola dati, 
)SFFF 16385 etc. etc. 


Il caricatore dell’EX/BASIC non riconosce i riferimenti esterni (REF). Per 
accedere alle utilità, come VSEW, gli indirizzi delle utilità devono essere EQUagliate 
con i loro nomi. Queste utilità sono locate a indirizzi diversi di quelli usati in TI 
BASIC o ASSEMBLY, e non tutte le utilità sono supportate. Fer esempio, DSRLNK non 
viene supportata sotto l'EX-BASIC. Quando il vostro programaa ASSEMBLY sta girando 
dall ''EX-BASIC, o quando esso gira automaticamente, avendo incluso il punto di entrata 
dell'etichetta con la direttiva END, esso partirà nel workspace GPL. 11 workspace GPL 
parte a >BG5EO. Voi non dovete usare questa area come vostro workspace. Piuttosto, 
voi dovreste stabilire il vostro workspace, definendolo con l'istruzione LWPI 
all’inizio del vostro programma. @Cuesto è stato fatto fin'ora in tutti i progranmai 
esempio, e generalmente è una buona pratica. Allo scopo di far ritornare in maniera 
approprata il vostro programaa al programma che lo ha chiamato, voi dovreste il 
registro puntatore al workspace così che esso punti al workspace GPL prima di 
ritornare. 

Le seguenti istruzioni illustrano come questo viene fatto. 


GFLWS EQU »B3E0 Indirizzo iniziale del Workspace GPL 
SAVII ESS 2 Salva l'area per l'indirizzo di ritorno 
MYWS BSS >20 Mette da parte 32 byte per il mio WS 
# 
# 
START MOV RII,€@SAVII Salva l'indirizzo di ritorno 
LWPI MYWS Stabilisce il mio Workspace 
# 
% 
END LWPI GFLWS Ristabilisce il Workspace GPL 
MOV @SAVIL,RII Restituisce l'indirizzo di ritorno 
CLR STATUS Pulisce il byte dello STATUS GPL 
RT Ritorna 


Ecco un’altra maniera di finire il programaa che-lavora in qualsiasi ambiente, 
non importa se il vostro programma ASSEMBLY è chiamato da BASIC o EX-BASIC. Per 
questo metodo, i contenuti di RIili non necessitano di essere salvati. Le seguenti 
istruzioni illustrano questa tecnica. 
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esso 


GPLWS EGU ?2B3E0 


# 

+ 

END LWFI GPLWS 
CLR @STATUS 
B E>0070 


Ancora una volta, riecco il programma esempio del capitolo ottavo. Questa volta, 


è stato scritto con i cambiamenti necessari per chiamarlo dall'EX-BASIC. 
DEF 60 


aisi zinco soosoeossszoeszossososoesosososiss3f33î553555553f5f338 
# Il caricatore (LOADER) dell'EX-BASIC non riconosce i riferimenti 

* esterni (REF). Le utilitfà VWHTR, VSRW, VMBW, E KSCAN sono 

* accessibili includendo le direttive ECU, Gli indirizzi delle 

* utilità sono differenti in ambiente EX-BASIC. 


VUTR ECU 2203 

VSRW ECU 2020 

VMEW EGU )2024 

KSCAN EQU )201C 

# "GFLWS" Indirizzo del workspace GPL 


GFLHS EQU »86E0 

WR ESS 220 

STATUS ECU 2837C 

KEYVAL ECU )E375 

DTEN DATA dA 

BORDER DATA dDFFFF,>8080,>B0B0,>8080 
DATA >8080,>8080,}8080,>B080 
DATA >B8080,2B8080,>B080,>B8080 
DATA 2B080,>8080,>8080,>FFFF 

MSG6I TEXT ‘’«&* PRESS ANY KEY va’ 

MS62 TEXT ‘#* KEYSTROKE VALUE IS +’ 

M5S63 TEXT ‘’* PRESS REDO/ESCAFE  #° 

OFFST BYTE >60 

REDOV BYTE 706 

ESCV BYTE >OF 


EVEN 

GO LUPI WR 
LI R0, 0755 
BLWUP @VWTR 


* Gli indirizzi usati da queste istruzioni per accedere alla tavola 
#*# del colore, che è stata cambiata. 
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CLOOP 


BPUT 


ELOOP 


EXIT 


SCANI 


SCAN2 


FIGUR 


RO,}OB1F 

R1,25500 

@VSRW 

RO, 0800 

Ri,>1F00 

EVSBEW 

RO, )OBILE 

BPUT 

RO 

CLOOP 

R0O,0 

Ri ,BORDER 

R2,32 

EVMEW 

R0O,736 

EXIT 

R0O,32 

ELOOP 

RO,Z61 

R2,MSGI Indirizzo in CPU RAM del messaggio 
R3,22 Lunghezza del messaggio 
@PEASIC Stampa il messaggio 
ESTATUS 

€KSCAN 

@STATUS,ESTATUS 

SCANI 

R0,325 Indirizzo VDF RAM per il secondo messaggio 
R2,MS62 Indirizzo in CPU RAM del messaggio 
R3,22 Lunghezza del messaggio 
EFBASIC Stampa il messaggio 
RO,395 

@KEYVAL,RI 

EO0FFST,RI 

€VSEW 

R4 

@KEYVAL,R4 

R4,8 

R3,404 

R0,406 

@FIGUR 

R0,4B5 Indirizzo VDP RAM per il terzo messaggio 
R2,MS63. Indirizzo in CPU RAM del messaggio 
R3,22 Lunghezza del messaggio 
@PBASIC Stampa il messaggio 
@STATUS 

@KSCAN 

@sTATUS,ESTATUS 

SCAN2 

@KEYVAL,@REDOV 

SCAN2 

@BPUT 

R4,RS 
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R4 
EDTEN,RA 
R5,>0030 
RS,8 
RS,RI 
GOFFST,R1 
@VSBW 

RO 

RO,R3 
FIGUR 


# "ESCAF" Rimette a zero (Resetta) il puntatore al reqistro per il 
# workspace GPL, pulisce il byte di STATUS, e si dirama all'indirizzo 


* )0070 


MOVE 
AB 
BLWP 
DEC 
JNE 
RT 
END 


GFLWS 

@STATUS 

>0070 

#R2+4,h1 Muove un byte del messaggio in RI 
@E0FFST,RI Aggiusta per il BASIC 

@EVSEU Scrive un byte 

R8 Decrementa il contatore caratteri 
PEASIC Se non è zero, ripeti 


ss. altrimenti ritorna 


10 REM * PROGRAMMA IN EX-BASIC PER CHIAMARE # 
20 REM # IL FROGRAMMA ASSEMBLY DEL + 
30 REM * CAPITOLO OTTAVO * 
40 CALL INIT 
50 CALL LOAD("DSK1I.OBJECT") 
60 CALL LINKE("G0") 

70 CALL SCREEN(4) 

80 FOR LOOP=0 TO 16 

90 CALL COLOR(L00F,2,4) 


100 NEXT LOOP 


110 GOTO 60 
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In più, avendo programmi in BASIC e EX-BASIC chiamati dal programma ASSEMBLY, voi 
potete passare dati numerici e stringhe dall'uno all'altro. fGuesto può essere fatto 
con PEEK e FOKE, o può essere usata l'istruzione CALL LINK. L'indirizzo del punto di 
entrata in CALL LINK può essere sequito da un massimo di 16 variabili, che sono 
disponibili nel linguaggio ASSEMBLY per agire su di esso. 


Il seguente programma esempio simula l'istruzione DISFLAY AT dell 'EX-BASIC. Esso 
è scritto per essere girato dal TI-BASIC, con il modulo della M/M o dell'’E/A. 


Il formato di un programma in TI-BASIC che userà questo sottoprogramma varierà in 
dipendenza dal tipo di modulo che viene usato, e da quale configurazione Hardware 
userete con il vostro computer, 

Fer gli utenti della HM/M, chi ha già assemblato il progranma, memorizzato nel 
modulo, e aggiunto il nome del programma ed il punto di entrata alla tavola REF/DEF, 
dovrebbero usare questo formato: 


CALL LINK("DEF LABEL" ,RIGA,COL,STRINGA) 
Fer esempio 
110 CALL LINK("60",12,6,5#£) 


Gli utenti dell’E/f dovrebbero usare un formato simile a questo 
programma in TI-EBASIC. 


10 REM * PROGRAMMA IN BASIC PER CHIAMARE è* 
20 REM + IL PROGRAMMA ASSEMBLY * 
30 REM « "DISFLAY AT" * 
40 CALL INIT 

30 CALL LOAD("DSKI.BSCSUP") 

60 CALL LOAD(I"DSKI.OBJECT") 

70 INPUT “STRINGA?":5$ 

80 INFUT "RIGA?":R 

90 INFUT “COL?":C 

100 CALL LINK(“G0",R,C,5Sf) 

110 FOR DELAY=1 TO 500 

120 NEXT DELAY 

130 GOTO 70 


Le routine speciali usate in questo programma ASSEMBLY, conosciute come “Supporto 
al BASIC" (NUMREF, STRREF, ERR) sono incluse nel dischetto "A" dell’E/A. Queste 
devono essere caricate nel computer con un'istruzione BASIC come quella qui usata, 
CALL LOAD("“"DSK1.BSCSUP"), allo scopo di determinare i nomi simbolici di queste routine 
per il programma ASSEMBLY. Queste routine esistono già nel gsodulo della M/NM, così 
questa istruzine non è richiesta. Foi il file oggetto che è stato creato asseamblando 
il prograama viene caricato. Voi dovreste specificare il none del dispositivo che si 
adatta alla vostra situazione. 
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NOTA DEL TRADUTTORE: 
Anche questo programma viene listato a parte, per permettere un migliore 
controllo con le spiegazioni del programma. 


scesi 3f333-s3s3s3s33soesosoosocosossossaszscooo. 


Spiegazioni del programma “DISLPAY AT". 


Le linee 8 e 9 puliscono RO e caricano Ri con il valore di i. Questi registri 
sono usati dalle routine NUMREF e STRREF come indicatori. Il valore di RO dice alla 
routine che tipo di valore essa ritroverà. Il valore di Ri dice alle routine quale 
variabile deve essere ritrovata. Un "1" indica il primo valore passato dal programma 
EASIC all'istruzione CALL LINK. Il primo valore, in quest’esenpio, è il numero della 
riga. La linea 10 esegue una diramazione ed un’allacciamento (BL) alla routine 
"GETNUM" alla linea 32, 

NUMREF ottiene il valore (che è nel formato in virgola mobile) dal valore di STAK 
del TI-BASIC, e lo mette all'indirizzo >8:4h. Questo indirizzo è il "FLOATING POINT 
ACCUMULATOR" FAC = (Accumulatore in virgola mobile). Poi, la routine XMLLNK prende il 
numero e lo converte in intero (in effetti, un'espressione binaria su cui può agire un 
programma ASSEMELY), Il risultato di questa conversione è tuttora all'indirizzo del 
FAC (>8354h). 


Bisogna poi verificare che questo numero di riqga sia valido (da 1i a 24). La 
linea ll esegue un BL alla routine “CHELMR" della linea 359. Prima il valore viene 
confrontato al valore di LIM+2, che è 24. Foi il valore viene confrontato col valore 
a LIM che è 1. Se il valore della riga è magqiore di 24, o minore di I, allora viene 
fatto un salto all'etichetta ERFOR della linea 44. La routine di errore causa il 
messaggio "EAD VALUE" = (Valore errato), che sarà visualizzato, e ritornerà al 
programma BASIC. 


La linea 12 del programma ASSEMELY viene raggiunta solo quando il valore della 
riga è stato verificato come valido. La linea 12 muove il valore della riga in RA. 
Il valore necessario per calcolare l'indirizzo dello schermo in relazione al 
linquaggio ASSEMELY per questa riga è di uno in meno dell'effettivo valore recuperato. 
La linea 13 aggiusta per questa condizione DECrementando R4. L'’indirzzo dello schermo 
per questa riga è uquale al valore ora in RA, aoltiplicato per 32. La linea 14 compie 
questa operazione spostando i bit di R4 a sinistra di 5 posizioni. Ogni volta che i 
bit di un registro sono spostati a sinistra, l’effetto sul valore del registro è 
uguale a: VALORE * 2 N, dove N è il numero delle posizioni spostate a sinistra. 
Foichè R4 viene spostato a sinistra di 5 posizioni, e 2 5 è uguale a 32, si ha lo 
stesso effetto come moltiplicando per 32. Usare l’istruzione di spostamento a 
sinistra in questa maniera è un’abile sistema per esequire le moltiplicazioni, se il 
valore che voi desiderate moltiplicare è una potenza di 2. il valore ora in RA è 
l'indirizzo dello schermo della riga selezionata. La linea 15 salva questo valore in 
R7. 


La linea 16 aggiunge lì) al valore in RI prima che le linee 17 e 18 ritrovino e 
verifichino il numero della colonna. fAddizionando 1 a RI si dice alle routine NUMREF 
E STRREF di operare sul prossimo valore passato da CALL LINK. La linea 19 viene 
raggiunta solo una volta che il nunero della colonna è stato recuperato e verificato, 
Esso adiziona il valore della colonna all'indirizzo dela riga in R4. La linea 20 
addiziona I a questo valore per farlo corrispondere al modo in cui DISPLAY AT tratta 


99 


gli indirizzi di riga e colonna. 

Norma]mente, quando l'utente seleziona la riga i! e colonna I, questo trasferisce 
all'indirizzo 0 della Tavola Immagine dello Schermo, (TIS) la prima posizine sullo 
schermo. Comunque, DISPLAY AT riconosce solo le colonne da 3 a 30 di ogni riga, per 
una lunghezza di 28 byte. Così, se viene selezionata la riga 1 e la colonna 1, la 
visualizzazione effettiva comincia dalla riga i e colonna 3. Le colonne 1, 2, 53i, e 
32 di ogni riga contengono caratteri di riempimento, e non sono usate per 
visualizzare. Il registro quattro ora contiene l'indirizzo della TIS in VDP RAM, che 
corrisponde al numero della riga e colonna selezionata, 


Alla linea 21, RI è ancora incrementato per indicare a STRREF che esso deve 
operare sul prossimo valore passato da CALL LINK. L'utilità STRREF recupera la 
stringa EnSIC, e la converte in una stringa in linguaggio ASSEMBLY. La linea 22 
carica R2 con l'indirizzo di dove la stringa deve finire (SBUF). 

Il primo byte del buffer di stringa deve essere un valore che fissa il aassiao 
numero di byte da accettare. Quando la stringa è ritornata da STRREF essa partirà dal 
byte SBUF+1, ed il primo byte (SBUF+0) sarà cambiato per riflettere l'effettiva 
lunghezz della stringa. Il massimo numero di byte accettati è di 255, o >FF. La 
linea 23 usa l'istruzione SETO, la quale fissa a uno tutti i bit nell'indirizzo 
nominato. Buesto è l’effetto opposto dell'istruzione CLR che fissa a zero tutti i 
bit. Se tutti i bit di una Word in memoria sono fissati a uno, il valore Hex di 
questa Word è >FFFF. La linea 24 esegue il ELWP a STRREF, che effettivamente ottiene 
la stringa. La linea 26 muove l'indirizzo del buffer stringa a R3 poichè R2 sarà 
usato più tardi. La linea 27 muove la lunghezza della stringa trovata nel primo byte 
del buffer stringa a KS, il quale era stato pulito alla linea 25. La linea 27 usa la 
caratteristica di indirizzamento con autoincremento, lasciando che l'indirizzo in RJ 
punti a SBEUF+1 dopo che è stato mosso. Se la lunghezza della stringa è zero quando 
viene mossa in fS, il bit di uguaglianza verrà messo a uno nel registro di STATUS, 
Ruesta condizione viene controllata alla linea 28, che dirige la logica al progransa 
di chiamata, poichè una lunghezza zero indica che nessuna stringa è stata passata. La 
linea 29 usa l'istruzione SWAF BYTE (SWPB) = (Scambia i byte), per cambiare il valore 
in RS dal byte sinistro al byte destro. Se il valore mosso in RS alla linea 27 era 
>FF, allora RS conterrà )O00FF. Dopo l’istruzione SWPE, RS contiene >FF0O00, o 255 Dec. 
La linea 30 esegue un BEL alla routine "FRINT"” che visualizzerà la stringa alla 
locazione desiderata sullo schermo. 


La linea 47 carica Ré con il valore di offset dello schermo che deve essere 
aggiunto a qualsiasi codice dei caratteri ASCII prima che essi possano essere 
visualizzati da un programma ASSEMBLY che è stato chiamato dal BERNSIC, La linea 46 
addiziona 30 al valore in R7. Il valore in R7 era l'indirizzo dello schermo della 
riga selezionata. R7 ora contiene il valore dell'indirizzo dello schermo della 3Jiaa. 
colonna della riga prescelta. Se il nuovo indirizzo dello schermo in R4 ha raggiunto 
questo valore, allora è necessario muovere alla prossima riga prima di continuare con 
la visualizzazione della stringa. 


La linea 49 muove l'attuale indirizzo dello scherao in R4 a RO. La linea 50 
muove un byte dal buffer stringa a RI e autoincrementa l'indirizzo in RS di uno.La 
linea Si addiziona il valore di offset dello schermo (>60) a RI prima che la linea 52 
lo scriva sullo schermo con la routine VSBW. Le linee 53 e 54 incrementano 
l'indirizzo dello schermo, e decrementano il contatore dei caratteri dopo ogni 
scrittura. Se il valore in RS raggiunge zero, il bit di uguaglianza del registro di 
STATUS viene fissato a uno. La linea 55 controlla questa condizione e dirige la 
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logica della routine all'etichetta "Li" finchè RS non è zero. Se RS è uguale a 
zero, allora tutti i caratteri della stringa sono stati visualizzati, e la linea Sé 
ritorna al programma. 

La linea 57 confronta i nuovi indirizzi dello schermo da essere usati con il 
valore in R7. Se R4 è maggiore o uguale a R7, il prossimo byte da essere visualizzato 
dovrebbe andare alla prossima riga partendo dalla colonna tre. Se R4 è minore di R7, 
la linea SB dirige la logica all'etichetta “PLOOP" per scrivere un'altro byte. Le 
linee 59° e 60 aggiustano l'indirizzo dello schermo, ed i valori limite della riga, per 
la prossima riga, terza colonna. La linea é1 confronta il valore limite della riga 
con 766. La riga massima utilizzabile che dovrebbe essere stata selezionata è 24, 
L'indirizzo della prima colonna alla linea 24 è uguale a 7536. Addizionando il valore 
limite della riga a questo si ha il massimo valore per R7 di 766. Se R7 è maggiore o 
uguale a 766, lo schermo attuale visualizzato deve fare uno “scroll” in su, prima che 
il resto della stringa possa essere visualizzato. Finchè questo valore tasiao non g 
stato raggiunto, la linea 62 salterà all'etichetta “PLOOP® per scrivere un'altro byte. 
La linea é3 eseque un BL a SCROLL quando il valore massimo in R7 è stato raggiunto. 

L'eifetto dello scroll della visualizzazione sullo schermo è di muovere tutti i 
valori della tavola schermo in su di una riga e riempire la riga inferiore con degli 
spazi. Qualunque cosa visualizzata sulla prima riga sarà perduta appena lo scroll 
dello schermo sarà effettuato. 

Fer aiutarvi in questo, un buffer di memoria temporaneo viene messo da parte alla 
linea 5 per mantenere una riga di dati (32 byte). Le linee 67, 68, e 69 caricano i 
valori iniziali necessari per l'operazione di scroll. 1 valori dell'indirizzo in VDP 
RAM in RO è inizialmente fissato a -32 perchè la linea 70 addiziona 64 ad esso ogni 
volta attraverso il ciclo chiamato L4. La prima volta attraverso questo ciclo, RO 
diventa uguale a 32, l'indirizzo della riga 2. Ri deve contenere l'indirizzo del 
buffer di linea e R2 la lunghezza, cioè 352 byte. 


La linea 71 legge una riga di caratteri dello schermo nel buffer di riga (LEUF), 
La linea 72 aggiusta l'indirizzo VDP RAM in RO per 32 e la linea 73 controlla il nuovo 
valore per vedere se lo scroll è stato fatto. Se il nuovo valore in RO è uquale a 
>2E0, la logica salta all'etichetta SI. Altrimenti, la logica continua a NP alla 
linea 85. La linea 83 scrive il contenuto del buffer di linea al nuovo indirizz 
schermo, e la linea 84 salta all'etichetta L4 per completare il ciclo. Buesto ciclo 
continua finchè il confronto alla linea 73 è vero, nel qual caso la logica salta 
all'etichetta Si. Le linee da 77 a 82 copiano l'indirizzo del buffer di linea, e la 
sua lunghezza nei registri R13 e RI4, e procedono a rienmpire il buffer di linea con 
spazi (>20). La linea 82 li mantiene ritornando al'etichetta L3 finchè tutti i 32 
byte del buffer di linea siano stati riempiti con spazi. La logica della routine, poi 
va alla linea 83 la quale scrive i contenuti del buffer di linea (tutti spazi) 
sull'ultima riga dello schermo. 


La logica si trasferisce all'etichetta L4. Il confronto alla linea 73 ora non ha 
effetto sulla logica di SCROLL, e la linea 76 ritorna alla linea 64 di PRINT. Dopo lo 
scroll, il limite e i valori dell'indirizzo schermo sono aggiustati per -32 alle linee 
64 e 65 prima di continuare a visualizzare il resto della stringa. 


Quì inclusi vi sono due programmi che dimostrano l’uso l'uso delle routine 
ASSEMBLY con il TI BASIC o 1'EX-BASIC 
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DEFINIZIONE DEI CARATTERI ASSEMBLER 


Questo programma ridefinisce il set di caratteri standard così che le lettere 
minuscole appaiano come "VERE" minuscole, cioè, con le parti discendenti. Questo 
significa che le parti terminali delle lettere p, q,; 9, i, e y, possono essere 
stampate sullo schermo. Inoltre, sono stati definiti alcuni caratteri di lingua 
straniera. Le istruzioni DATA in questa routine usano lo stesso tipo di codice dei 
caratteri dell'istruzione CALL CHAR del TI BASIC. I caratteri con il codice ASCII da 
350 a 126 sono provvisti di definizione. Lo spazio per ridefinire i caratteri da 127 a 
143 è stato incluso, così che voi potete usare questa routine per definire velocemente 
i caratteri grafici all'inizio di un progranna BASIC o EX-BASIC. 


Notate che questo programma non può essere assemblato se il codice sorgente sia 
1'EX-BASIC DEF/EGU e 1'E/A DEF/REF., Per usare il programma sia con iì TI BASIC o 
1'EX-BASIC, salvare le versioni separate del codice sorgente e assenblare i due file 
oggetto su due dischi separati. La versione in EX-BASIC dovrebbe essere assenblata 
con l'opzione “C" (compressa). Il nome del file oggetto dovrebbe essere 
"DSk1.CHARDF". 


Per chiamare la routine dal vostro programma in BASIC o EX-BASIC, voi dovrete 
usare la seguente routine all’inizio del programaa. 


100 CALL INIT 

110 CALL CLEAR 

120 CALL LOAD("DSK1.CHARDF") 
130 CALL LINK("CHARDF") 


Se voi usate l'EX-BASIC, voi potete salvare la routine di cui sopra con il nome 
del file "DSKI.LOAD®, Cuando voi selezionate 1'EX-BASIC, esso partirà 
automaticamente. Poi qualsiasi prooramna in EX-BASIC che tarete qirare avrà i 
caratteri definiti dalla routine se voi userete un'istruzione CALL LINK("CHARDF"). 
Una volta che la routine è caricata nell'espansione di memoria, non è necessario 
ricaricarla, a meno che l'espansione non venga spenta. 


* DEFINIZIONE CARATTERI ASSEMELER # 
Li di David Migicovsky # 
* Copyrigt (c) 19835 * 
# by Steve davis Publishing 4 


LE DUE RIGHE CHE SEGUONO SONO 
PER LA VERSIONE IN EX-BASIC 


DEF = CHARDF,VMBW 
VMBW EGU  >2024 


LE DUE RIGHE SEGUENTI SONO PER 
L'USO CON IL TI BASIC E L'’E/A 


DEF CHARDF 
REF VMBW 
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IDENTIFICATORE FATTERN *CARATT. ASCII 


NEWDEF DATA >7C7C,>6C6C,>6C6C,>7C7C x 38 
DATA >0000,>9200,>2000,>0080 * 31 
DATA >0000,>0022,>2000,>0099 "o" 32 
DATA >1010,>1010,>1000,>1000 * "1" 33 
DATA >2828,>2800,>0200,>00200 we 34 
DATA >2828,>7C28,>7C28,>2800 *wo"a” 35 
DATA >3854,>5038,>1454,>3820 * "$" 36 
DATA >6964,>08109,>204C,>0C89 * "2" 37 
DATA >20950,>5020,>5448,>3400 * "a" 38 
DATA >2898,>1000,>0000,>0009 wi 99 
DATA >0810,>2020,>2010,>0800 sai Cee | 
DATA >20109,>9808,>0810,>2080 * ")" 4l 
DATA >0028,>107C,>1028,>0000 «ne 42 
DATA >0010,>107C,>1019,>2000 * "+" 43 
DATA >9000,>02009,>0930,>1020 i. 
DATA >0000,>997C,>9900,>9900 SO 
DATA >0000,>9000,>9930,>39020 Ca 40 
DATA >0004,>0810,>2040,>0900 pa Ae i 
DATA >3844,>4444,>4444,>3800 Pai La 
DATA >1939,>1010,>1010,>3800 = 235 
DATA >3844,>9498,>1920,>7C80 "2038 
DATA >3844,>0418,>0444,>3800 =. cena 
DATA >02818,>2848,>7C08,>98020 *« "4° 52 
DATA >7C40,>7804,>0444,>3800 "29 
DATA >1829,>4078,>4444,>3800 n 
DATA >7C04,>0810,>2020,>2000 ES? 
DATA >3844,>4438,>4444,>3800 SESTO 
DATA >3844,>443C,>9498,>3000 sno ai 
DATA >0032,>3000,>2330,>09008 x ix33 
DATA >0000,>3030,>0C30,>1020 33 
DATA >0818,>20409,>2019,>9800 Si 
DATA >9080,>7C08,>7C00,>0909 ea: 
DATA >2C10,>0894,>0810,>2099 * "> 62 
DATA >3844,>9408,>1098,>1290 * "2° 63 
DATA >3844,>5C54,>5C40,>380£ * "e" 64 
DATA >3844,>447C,>4444,>44098 * "A" 65 
DATA >7824,>2438,>2424,>7800 * "B" 66 
DATA >3844,>4040,>42944,>3809 * "C* 67 
DATA >7824,>2424,>2424,>7800 * "D" 68 
DATA >7C49,>4078,>4040,>7C99 * "E" 69 
DATA >7C40,>4078,>4040,>4000 * “F" 79 
DATA >3C40,>405C,>4444,>3800 * “*G* 71 
DATA >4444,>447C,>4444,>4400 * “ku® 72 
DATA >3810,>1010,>1010,>3800 * "I" 73 
DATA >02404,>9404,>0444,>3800 * "JI" 74 
DATA >4448,>5060,>5048,>4400 * "Ka 75 
DATA >4040,>4040,>4040,>7C00 * "L" 76 
DATA >446C,>5454,>4444,>4400 * "M® 77 
DATA >4464,>6454,>4C4C,>4400 * "N° 78 
DATA >7C44,>4444,>4444,>7C90 ‘# "O" 79 
DATA >7844,>4478,>4040,>4000 * “p* gg 
DATA >3844,>4444,>5448,>3400 * "Q* gl 
DATA >7844,>4478,>5048,>4400 * “R® 82 
DATA >3844,>4038,>0444,>3800 * "S" 83 
DATA >7C10,>10109,>1010,>10900 * "T" 84 
DATA >4444,>4444,>4444,>3800 * "U" g5 
DATA >4444,>4428,>28109,>1000 * "V" 86 
DATA >4444,>4454,>5454,>2800 è “W° 87 
DATA >4444,>2810,>2844,>4400 * "x" 88 
DATA >4444,>2810,>1010,>1000 * ny 89 
DATA >7C094,>9810,>2040,>7C00 * “2° 90 
DATA >0810,>3844,>7C40,>3800 * "[{" 91 
DATA >3030,>3FFF,>FE7C,>180C * “\° 92 
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CHARDF 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


LI R0,1098 *THIS IS A DECIMAL NUMBER 


>2010,>3844,>7C40,>3800 
>3844,>40949,>4438,>1009 
>1028,>0038,>4848,>3400 
>0000,>3840,>4038,>1000 
>0000,>3848,>4848,>3400 
>6020,>3824,>2424,>7800 
>0009,>3844,>4044,>38009 
>0C08,>3848,>4848,>3C020 
>0000,>3844,>7C49,>3800 
>1824,>2070,>2020,>2009 
>0000,>3C44,>3C04,>0438 
>6920,>2834,>2424,>24008 
>1000,>70109,>1010,>7C00 
>0800,>1808,>0848,>4830 
>2020,>2428,>3028,>2400 
>3010,>10109,>1010,>7C099 
>0000,>A854,>5454,>5400 
>00090,>5824,>2424,>2400 
>0000,>3844,>4444,>3800 
>£000,>7824,>2438,>2920 
>0000,>3048,>38098,>0809C 
>9000,>5824,>2020,>2000 
>0009.>3C40.>3884.>7800 


>2020,>7820,>2924,>1800 
>0000,>4848,>4848,>3400 
>0000,>4444,>2828,>1000 
>0000,>D454,>5454,>2800 
>0000,>4428,>1028,>4400 
>0000,>4444,>3C04,>0418 
>0000,>7C48,>10924,>7C00 
>1820,>2040,>2020,>1800 
>129109,>1000,>1010,>1000 
>3008,>0804,>0808,>3000 
>0000,>2054,>0800,>9000 
>0000,>0000,>0000,>0000 
>0000,>0209,>9000,>0000 
>0000,>929009,>0290,>0000 
>00009,>00009,>20000,>0000 
>0009,>90009,>0020,>0000 
>0090,>0200,>90099,>0000 
>0000,>0209,>0000,>0000 
>0000,>0900,>0200,>0900 
>2000,>9098,>00900,>0000 
>0000,>0200,>20009,>0000 
>0000,>9200,>0009,>2000 
>0000,>90009,>0000,>0009 
>00009,>00009,>9200,>0000 
>0000,>0200,>6290,>0009 
>0000,>02909,>29020,>00068 
>9009,>2009,>2000,>0000 
>0909,>0920,>2000,>0009 


LI RI, NEWDEF 


LI R2,904 


BLWP 
RT 
END 


@VMBW 


{02 ABuU£ 


*THIS IS A DECIMAL NUMBER 


> + + # © 2 1 2 1 1 do 1 1 1 1 1 1 I 1 o 1 11 © 1 # 1 1 1 2 2 1 2 1 1 1 1 1 2 11 1 2 1 


"]}” 
era 
o» 
ele 
va” 
"pr 
.c* 
"d® 
"e" 
fo 
"g" 
"h® 
n{®» 


k" 
"]}® 
®m” 


"o" 
Ans 
sale tg 
e®* 
sg" 
ai Shel 
"u® 
Ly" 
fy® 
"7° 
{e 
ali Dre 
La i 


93 
94 
95 


97 

98 
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100 
101 
192 
103 
194 
105 
1096 
107 
108 
109 
119 
111 
112 
li 

114 
115 


116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
2135 
136 
137 
138 
139 
140 
141 
142 
143 


DEFINIZIONE CARATTERI CON LA M/M 


Per usarlo con l’'assembler linea per linea e la M/M, cancellate tutte le linee 
eccetto le istruzioni DATA. Cambiate l'etichetta nella prima linea DATA (NEWDEF) con 


“ND". Inserite due nuove linee alloinizio del prograama, mettendo la prima istruzione 
DATA alla linea tre. 


AORGB >7D000 
VM EGU ) 6028 
ND DATA >7C7C,.... 
Inmediatamente dopo l'ultima linea di DATA, addizionate le sequenti 
linee.. 
CD LI R0,1008 
LI RI,ND 
LI R2,904 
BELWP E@VM 
CLR @06837C 
B #Ril 
END 


Per accedere alla routine da un progranaa BASIC, voi dovreste usare 
l'istruzione CALL LINK(“CD") 
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PROGRAMMA "BAR BRAPH" 


Questo programma esempio è stato creato da due appassionati del TI-99/4A 
dell'AUSTRALIA, i sigg. PHILL WEST e BERNIE ELSNER. 

E una routine progettata per essere chiamata da qualsiasi programma in TI BASIC 
con i moduli M/M o 1l’E/A inseriti, La routine permette di tracciare in alta 
risoluzione Barre di Brafici in vari colori, Per accedere alla routine usare 
l'istruzione BASIC CALL LINK ("EGRAPH®,COLUMN,COLOR,HEIGHT). 

COLUMN dovrebbe essere un nurero tra i e 26, la colonna dello schermo nel quale 
la barra apparirà. COLOR è il colore della barra, un numero da 1 a 7, come qui sotto 
indicato. 


NUMERO DEL COLORE COLORE SET DI CARATTERI USATI 
1 NERO 10 
= ELU SCURO 11 
5 ROSSO SCURO 12 
4 GIALLO SCURO 13 
Ò VERDE SCURO 14 
I) MAGENTA 15 
7 BIANCO 16 


HEIGHT dovrebbe essere un numero tra i e 160, indicando con questo, quante 
righe/pixel sarà alta la barra. Tutte le barre vengono disegnate iniziando dalla riga 
20, e possono estendersi verso l'alto, fino alla prima riga. fuesto lascia libere le 
righe dalla 21 fino alla 24 per il testo da visualizare. 

Di seguito al listato ASSEMELY vi è un programma dimostrativo in TI BASIC che vi 
permette di vederne i risultati. Se voi vorrete usare il modulo E/f, dovrete caricare 
il file di supporto EASIC dal dischetto “A" dell'E/A. 1ì programma dimostrativo vi 
suggerisce di di mettere il dischetto nel drive 1. Il codice oggetto del progranma 
ASSEMELY BAR GRAFH dovrebbe essere salvato sul dischetto con il nome del file di 
"BGRAP/0" (per Bar Graph Oggetto), e dovrebbe essere sul drive 1 quando fate girare il 
"Demo". 


* ROUTINE EAR-GRAFH 
* PER L'USO CON LA M/M DAL BASIC 
* DI PHIL WEST E BERNIE ELSNER 


DEF = BGRAPH 
REF VMEW,VSBW,NUMREF,XMLLNK,ERR 


DI DATA 0000 * Definizione dei caratteri 
DATA >0000 % 
DATA >0000 * 
DATA >003C * 
DATA >3I3C3C * 
DATA >IC5C # 
DATA >ISC3C Li 
DATA >SCS3C # 
D2 DATA >1040 * Byte dei colori 
DATA >6éEOAQ * 
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EGRAFH 

% 

* Ottiene 
* 


x mo sd si 


D WU 


DATA 
DATA 
CLR 


i tre 


LI 
BLWP 
ELWP 
DATA 
MOV 
CI 
JGT 
E 

CI 
JLT 
B 
INC 
ELWP 
ELWP 
DATA 
MCV 
CI 
J6T 
E 

CI 
JLT 
B 
INC 
BLWP 
BLWP 
DATA 
MOV 
CI 
JGT 
B 

CI 
JLT 
B 


>CODO 
2F000 
RO 


parametri dalla lista LINK 


R1,?0001 
@NUMREF 
EXMLLNK 
>1200 
E834A,R3 
R3,20000 
C 

eE 
R3,2001D 
F 

GE 

Ri 
ENUMREF 
EXMLLNK 
>1200 
€>B34A,R4 
R4,0000 
6 

GE 
R4,)0008 
H 

E 

RI 
ENUMREF 
@XMLLNK 
>1200 
€>6&344,R5 
R5,0000 
J 

«Rii 
R5,700A1 
K 

GE 


* Ottiene il primo parametro. 


*# Controlla se il valore è valido. 


* Ottiene il secondo parametro. 


* Controlla se il valore è valido, 


*# Ottiene il terzo parametro. 


* Controlla se il valore è valido. 


Downloaded from www. ti99iuc.it 


LI 
LI 
LI 
BLWP 
À 
INC 
CI 
JLT 
CI 
JLT 


Definisce i caratteri 


R2,)0008 
R0,}0640 
Ri,Di 
@VMBW 
R2,R0 

RI 
R1,D1+8 
A 

RO, 0800 
B 


* Quanti byte da scrivere, e inc.per RÒ. 
* Scrive l'indirizzo in VDP 
* Indirizzo in RI dei DATA dei caratteri. 


* Scrive 8 byte nella tavola dei caratteri 


Incrementa di 8 per il pross. carattere 
Si sposta in sotto di una riga DATA. 
Ultimo indirizzo DATA? 

No, ricomincia da "A" 

Ultimo carattere da definire? 

No, fare il prossimo carattere 


spe alt spa nt spe se 
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# Definisce il set colori dei caratteri 


* 
LI RO, 20319 * Indirizzo VDP per il set caratteri N°10 
LI R1,D2 * Set dei colori 
LI R2,)0007 * 7 byte da scrivere 
BLWP  €VMBW 
# 
* Determina il carattere da usare 
4 
SLA R4,3 * Moltiplica per 8 
AI R4,)00C0 # 192 meno l'offset di 96 = 96+8 = 104, 
* che è il primo carattere del set N°10 
SWPB R4 * Carattere da usare 
LI Ré6,}0200 * Decrementa il valore della riga 
LI RO,}0261 * Fissa la riga 20 e colonna 2 
A RS,RO # Colonna da usare 
+ 
* Disegna la barra, un pixel alla volta. 
+ 
N CLR __R7 * Azzerra il contatore 
MOV R4,RI # Si prepara a scrivere il 1° byte 
M ELWP  &VSEW # Scrive un byte 
DEC RS * Riduce la barra di una riqa di pixel 
P CI R5, 20000 * Finito? 
JGT L * No, continua 
B «Rii * Si, ritorna al EASIC 
L AI RI,>0100 # Ottiene il prossimo carattere 
INC R7 * Incrementa il contatore 
CI R7,20000 #* Scrito un carattere intero? 
JLT M * No, continua 
S R6,R0 # Si, decrementa la riga 
JMP N # Continua con la prossima riga 
1) 
* Parametro d'errore 
® 
E LI RO,21500 *# Errore, valore sbagliato 
BLWP EERR 
END 
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Ed ecco il programma chiamante in BASIC. 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
250 
240 
250 
260 
270 
280 
290 
300 
310 
320 
350 
340 
350 
3560 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 


REM DEMO BAR GRAPH 
REM TI BASIC CON M/M 0 

REM MODULO E/A 

REM BY FHIL WEST E BERNIE ELSNER 

CALL CLEAR 

RANDOMIZE 

PRINT "METTI IL FILE ‘EGRAPH/O' NEL" 
PRINT "DISK DRIVE 1, POI":"FREMI ENTER 
INPUT E$ 

PRINT "CARICO IL LINGUAGGIO MACCHINA “:"FREGO ATTENDERE" 
CALL INIT 

CALL LOAD("22706,0,0,0,0,0,0,0,0") 

CALL LOAD("DSK1.BGRAFH/0") 

FRINT "CHE MODULO USI?": "INSERIRE" 
PRINT " #E* PER L'E/A, #M* PER LA M/M" 
INPUT E$ 

IF E$=M THEN 350 

IF E$*<>E THEN 250 

PRINT “METTI IL DISCO "A" DELL'E/A" 
FRINT "NEL DRIVE 1, POI":"PREMI ENTER" 
INFUT E$ 

CALL CLEAR 

CALL LOAD("DSK1.BSCSUP") 

REM RISERVA SPAZIO PER LA DEFINIZIONE DEI CARATTERI 
REM NELLA ROUTINE IN LINGUAGGIO MACCHINA 
FOR I=104 TO 159 

CALL CHAR(I,"*) 

NEXT I 

CALL CLEAR 

CALL SCREEN(15) 

FRINT " PROFITTI 1982-84 

PRINT " (Q)UIT 0 (R)IPETERE" 

F=1 

FOR I=i TO 28 

F=F#1,195 

CALL LINK("EGRAPH",I,1,F) 

NEXT I 

FOR D=1 TO 800 

NEXT D 

FOR I=1 TO 28 

CALL VCHAR(1,1+2,32,20) 

CALL LINK("BGRAPH",1,6,F) 

F=F/1,195 

NEXT I 

FOR D=1 TO 800 

NEXT D 

CALL HCHAR(1,1,32,640) 

REN GENERA PARAMETRI CASUALI 

FOR I=i TO 28 
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590 B=INT(RND+*7+1) 

600 C=INT(RND0+1) 

610 REM DISEGNA LE BARRE CON LA ROUTINE IN L/M 
520 CALL LINK("BGRAPH",1,B,C) 

630 NEXT I 

540 CALL KEYC0,K,5) 

650 IF K=82 THEN 380 

660 IF K<>B1 THEN 640 

670 END 


MANUALE DI RIFERIMENTO E/A 


I seguenti riferimenti vi forniranno altre informazioni su come unire l'ASSEMBLY 
con il BASIC. 


Leggere queste sezioni. 


Dalla sezione 17-1 paa. 275 alla sezione 17-2-6 pag. 289 
Sezione 18-2-5 pag. 3500 

Sezione 21-1 pag. 326 

Dalla sezione 24-4 pag. 410 alla sezione 24-4-9 pago. 418 
Dalla sezione 24-11 pag. 440 alla sezione 24-11-53 pag. 442 


GUARDARE QUESTI TERMINI SUL GLOSSARIO 


GPL 

Loader (caricatore) 

Utilità 

Workspace (spazio di lavoro; 0 spazio registri) 

Workpace pointer register (puntatore ai registri workspace) 
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CUALCHE CONSIGLIO... .FRIMA DI LASCIARCI 


Ci sono parecchi punti, a parte l'effettiva comprensione del linguaggio ASSEMBLY 
del TM59900, che possono aiutarvi a programmare in questo linguaggio un po più 
faciimente, ed in maniera più produttiva. (@uesto implica certe procedure, e abitudini 
di lavoro, ed apprezzano il lavoro fatto a mano quando si sta creando un programaa 
ASSEMBLY. 


Non importa fino a che punto voi siete, o potete diventare esperti con la 
programmazione ASSEMELY, non è quasi mai pratico o sensato iniziare battendo 
semplicemente le linee di codice di un nuovo programma, Sebbene questo possa essere 
possibile con il BASIC, ciò non è consigliabile con 1'ASSEMELY. Una volta che voi 
avete deciso l'applicazione che desiderate scrivere nel linguaggio del TMS9900, 
cogliete il momento giusto per delineare il vostro programma con carta e matita, prima 
di mettervi al computer. Come sottolineato all'inzio di questo libro, il linguaggio 
ASSEMELY richiede una grande quantità di dettagli per ogni piccola cosa che voi avrete 
bisogno di fare. 


Consultate qualsiasi materiale di riferimento che avete a vostra disposizione per 
assicurarvi che il primo abbozzo del vostro programma sia il più possibile libero da 
errori, sia dì sintassi che di logica. Fate uso delle parti di programma che avete 
scritto in precedenza. Molti programmatori professionisti tengono un’inventario delle 
subroutine che essi hanno sviluppato, e che possono essere riassembìlate mnodularrnente 
per formare la base di applicazioni in nuovi programmi. 


Ad un livello molto fondamentale, voi dovreste fare molta attenzione alla 
struttura e progetto dei vostri programmi. I linquaggi ASSEMBLY sono come base, 
libere forme di linguaggio. Finch’è le regole della sintassi vengono rispettate, le 
direttive, le istruzioni e dati possono apparire in qualsiasi ordine. (Questo è uno di 
quei casi dove la libertà non è certamente una buona cosa. ll programmi esempio dati 
in questo libro seguono tutti un modello o un formato prescritto. Le direttive, i 
dati delle istruzioni, riferimenti, ed uguaglianze sono tutte elencate prima. Queste 
sono poi seguite dalle effettive istruzioni del programma. Tanto quanto è possibile i 
vostri programmi dovrebbero incorporare uno schema "Top Down" = (dall’alto al basso). 
Come voi leggete i programmi dall'alto al basso, cosi dovrete seguire la logica 
sequenza degli avvenimenti come essi si succedono. 


Se voi state per creare un quadro, una sinfonia, o un grattacielo, progettare e 
pianificare con molta cura è importante per completare con pieno successo la vostra 
creazione. Lo stesso criterio viene applicato creando un programma ASSEMBLY. Voi 
avrete bisogno di considerare in anticipo come affrontare l'incarico. Voi dovete 
anticipare le necessità del progranna stesso, come un temporaneo campo di 
memorizzazione per i calcoli e manipolazione dei dati. Controllare le funzioni 
ripetitive che possono essere codificate come subroutine. Documentate il vostro 
programma con coamenti ed etichette che spiegano la sua logica. Allineate 
coerentemente le etichette, istruzioni ed operandi sul limite della colonna che essi 
occuperanno. Questo renderà il vostro programma più facile da leggere. Fate molta 
attenzione alla chiarezza, perchè normalmente rende gli errori più facili da scoprire. 


Sviluppate un vostro proprio stile nel progettare i programmi, ed attenetevi ad 
esso. Prendete in prestito liberamenteda altri esempi che trovate da sostituire per, 
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o apportare delle migliorie al vostro progetto. Voi potete imparare moltissimo dagli 
altri programmatori ASSEMELY. Un buon sistema per trovare questo tipo di aiuto è 
quello di associarsi con altri utenti della stessa zona, possibilmente più esperti. 
E, ricordatevi, che uno dei vostri migliori insegnanti è semplicemente: PROVARE e 
SBAGLIARE. 


Molti prodotti sono disponibili per aiutarvi nello sviluppo e "Debugging" 
(ricerca e correzione degli errori). Come menzionato, questi includono calcolatori 
HEX speciali, e package di software come la serie della TEXAS “AIUTO ALLA 
FROGRAMMAZIONE I-II-III. Esistono anche disassenblatori che riconvertono il codice 
oggetto nel codice sorqente. Sia l'’assembler linea per linea, che l’E/A hanno un 
programma interattivo di “debugging" che vi assiste nella vostra programmazione. 
Frofessionisti ed hobbysti traggono vantaggi da questi prodotti di aiuto. Comunque, 
bisogna sottolineare che nessuno di questi è un sostituto per una fondamentale 
comprensione dei principi del linguaggio ASSEMBLY. 


Ricordate di fare sempre delle copie di Back Up dei programmi e dei file di dati, 
prima di far girare i programmi, o accedere ai dati. @uesto può salvarvi dal sal di 
testa e dalla frustrazione. Un computer che lavora bene abitualmente, diventa più 
critico quando lavora neì linguaggio ASSEMELY. 


Se voi state usando l’E/A, una stampante è una delle periferiche più utili che vi 
possiate avere. I listati che voi farete con lei sono un'aiuto prezioso per il 
"debugging" dei programmi, e creano una documentazione che più di una volta vi verrà 
in aiuto per controllare il programma. Questo richiede di leggere il prograama una 
linea alla volta. Come voi incontrate ogni linea di codice, prendete nota di cosa e 
stabilito, e registrate il risultato come voi lo capite su un pezzo di carta. Fer 
esempio, disegnate un gruppo di colonne e segnate la parte alta di ciascuna con il 
nome dell’eticheta o registro implicato. Foì, come i valori vengono inizializzati o 
cambiati, registrate questi valori nella colonna corretta. Tracciate una linea 
attraverso il valore precedente, quando questo cambia. Non cancellatelo, perchè poi 
potreste avere bisogno di riferirvi a lui in un secondo tenpo. Frendete nota del 
numero di linea che ha causato il cambio. Questo vi mostrerà i contenuti di ogni 
registro o campo ad ogni passo. Se voi incontrate una istruzione per sommare i 
contenuti di due registri con valori che sono stati determinati 20 linee prima, i 
valori da essere sommati saranno nelle corrispondenti colonne da voi create. 


Sviluppate buone abitudini di lavoro, con disciplina, e imparate a fare 
attenzione ai dettagli che vi aiuteranno nella programmazione in linquaggio ASSEMBLY, 
e in tutti gli altri tipi di interazione con il conputer. "LA PRATICA RENDE 
PERFETTI”. Fiù voi Lavorate con l'’'ASSEMBLY e più bravi diventerete con esso, 
Naturalmente, questo richiede qualche sforzo e sopratutto determinazione da parte 
vostra. Sarete però ricompensati con un'accresciuta comprensione del vostro computer, 
ed un potente strumento che mette il suo potenziale, cioè il linguaggio ASSEMBLY del 
TMS9900, al vostro comando. 


lil 
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Oi 
va 
DE 
04 
(a 
Ob 
07 
OG 
09 
10 
li 
12 
13 
14 


[2 
rh 


16 
17 
18 
19 
ZO 
2A 


RA 
dia‘ 


24 


ne 


26 
27 
29 
29 
ZO 
21 
nf Can) 


rx 
e 00 


39 
=5 
RI) 
37 
38 
39 
30 
41 
42 


STATUS 
SAVRTN 
AMTX 
AMTY 
DECTEN 
HEXZSO 
FNTANS 
WSFREG 
START 


ADDUF 


MASEDF 


FUTUF 


EOJ 


CLEAR 


LOOF' 


CLEARX 


PROGRAMMA ESEMFIO DELLA FAG. 21 


DEF 
REF 
EGU 
DATA 
DATA 
DATA 
DATA 
DATA 
ESS 
ESS 
LWF'I 
MOV 
EL 

A 
MOV 
CLR 
DIV 
A 
MOV 
MOV 
CL: 
DIV 
A 
SLA 
MOVE 
LI 
LI 
Ei 
ELWF' 
MOV 
CLR 
MOVE 
RT 
CLR 
CLR 
ELWP 
CI 
JEC 
INC 
JMF 
E 
EIND 


START 
VSBW, VMEW 
+B37C 
20000 
#000A 
+0021 
#000A 

OO ZO 

320 
3WSF'REG 
R11,@SAVRTN 
ECLEAR 
GAMTX, GAMTY 
GAMTY,F5 
R4 
@EDECTEN,R4 
GHEXZO,RS 
FS, @FNTANS 
R4,R5 

F:4 
EDECTEN,R4 
@HEXZO,R4 
FS,8 

RS, GFNTANS 
RO, 738 

Fi ,FNTANS 
R2,2 

@VMEW 
GSAVRTN,RI11 
RO 

RO, @STATUS 


RO 
R1 
EVSEW 
RO,767 
CLEARX 
RO 
LOOP 
*«Ri1 


99/4 
VERSIO 
0001 
0002 
VOOoZ 
0004 
0005 


0006 


0007 
0008 


0009 
VOLO 
VOl11 
0012 
OO13 


0014 


0015 


0016 
0017 


0018 
0019 
0020 
0021 
0022 


DOZI 


0024 
0025 


0026 


VO0OR7 


0028 


0029 


VOTO 


VO31 
0032 
0033 
DO03 
003 
003 


VOS7 


O 


O 
dI GA 


co 
0 o 


ASSEMDLER 


N 1.2 


0000 
0002 
0004 
V0O06 
0008 


000A 
V000C 
00ZC 
V0O2ZE 
VOTO 
OOIZ 
0034 


(O IOPRII 
0038 
OOZA 
VOZC 
OO03E 
0040 
0042 
0044 
0046 
0048 
0043A 
004C 
004E 
0050 
0052 
0054 
0056 
0058 
00OS5A 
OO0SC 
DOSE 
0060 
0062 
00654 
0066 
0068 
0O06A 
VO6C 
VO06E 
0070 
0072 
0074 
VO76 
0078 
CO7A 
O0O7C 
VO7E 
00BO 
0082 
0084 
00B6 
0088 
00B8A 
00BC 


8237C 
0000 
000A 
VOZI 
000A 
VOTO 


CRoB 
0000 
OZEO 


0000 


V6AO 
QU7E 
ABZO 
V00Z 


0004 | 


C160 


0004 | 


04C4 
SDZO 
0006 
A160 


0008 


C605 


. 


000A'° 


C144 
04C4 
3DZO0 
0006 
A120 
0008 
VABI 
DSO0S 


000A 


OZ0O0 
02E2 
OZ01 
VO00A 
OZ02 
2002 
0420 
0000 
CZEO 
0000 
04C0 
D800 

37C 
0458 
04C0 
04C1 
0420 
COo00 
0280 
O2FF 
1302 


0580 


STATUS 
SAVRTN 
AMTX 
AMTY 
DECTEN 
HEXZO 
FNTANS 
WSFFREG 
START 


ADDUF 


MASEUF' 


FUTUF 


EOJ 


CLEAR 


LOOF' 


FAGE 0001 


DEF START 

REF VSEW,UVHMEW 
ECU +837C 

DATA #0000 

DATA #000A 

DATA 0021 

DATA. 30006 

DATA FOGZO 

BSS è dii 

ESS #20 

MOV RiLl,E5AVRTH 
LWFI WSFREG 

BL @CLEAR 

A GAMTX, GAHTY 
MOV GAMTY.,RS 
CLKR FR4 

DIV EDECTEN,R4 
A GHEXZO,RS 
MOV RS, GFNTRNS 
MOV R4,F5 

CLR R4 

DIV EDECTEN,R4 
A GHEXZSO,R4 
SLA R5,8 

MOVE RS, EFNTANS 
LI RO, 738 

LI Ri,FINTANS 
LI R2,2 

BLWF'  @EVMBW 

MOV ESAVRTN,RII1 
CLR RO 

MOVB RO, ESTATUS 
RT 

CLKR RO 

CLR RI 

BLWF  EVSEW 

CI RO,767 

JEC CLEAFX 

INC RO 


99/4 ASSEMELER 


VERSION 1.2 FAGE 0002 
0040 008E 10F9 JMF LOOF 
0041 0090 045B CLEARX EB *Rli 
0047 END 


C'e. qui: la Tavola dei Simboli costruita dal programma. Ogni simbolo 
usato accanto al suo indirizzo, é. mostrato in ordine alfabetico. 
L'indirizzo dopo ciascun Simbolo puf' essere quello effettivo, (STATUS a 
>837C), O il valore del contatore di locazione. 


99/4 ASSEMELER 


SERSION 1.2 FABE 0003 
ADDUF' 0039 " AMTX 0002 * AMTY 0004 ‘ CLEAR 007E 
CLEARX 0090 DECTEN 0006 ‘ EOJ 0072 * HEX 30 0008 

‘ LOOF 0082 * MASKEUP 0048 * FNTANS 000A ‘ FUTUF 0062 
RO 0000 Ri 0001 RIO 000A Ril O006 
RIZ 000C RI3Z 000D R14 000€ RIS 0004 
RZ 0002 RI VO00S Fi4 0004 RS 0005 
Ré 0006 R7 0007 RE 0008 R9 0009 
SAVRTN O 0000 D START VOZC STATUS 837C E VMEW 0070 

E VSEW 0084 ‘* WSFREG O 000C 


0000 ERRORS 


DO 
VOR 
ODE 
004 
VOS 
O06 
007 
008 
009 
VIO 
O11 
012 
O13 
014 
15 
016 
017 
018 
019 
OTO 
OZI 
OL 


dio di 


ODI 


024 
025 
026 
027 
028 
029 
OZO 
31 
O32 
O33 
034 
O35 
(PRI, 
037 
038 
OT9 
040 
041 
042 
043 
044 
045 
046 
047 
048 
049 
OSO 
OSI 
052 
53 
054 
055 
OSì 
057 
058 


Unici =) 


FROGRAMMA 


FEYVAL 
STATUS 
FABIN 
FABOUT 
RECEUF 
FNTR 
CLOSE 
WRITE 
READER 
ENTV 
LEFTV 
RITEV 
CURVAL 
REDOV 
QUITV 


CURFAT 
BORDER 


ERRMSG 
TITI 
TIT2 
TITS 
TIT4 
TITS 
TOTI 
TOT2Z 
ORDI 
EQLN 
WATFLD 
FIELDI 
FIELD2 
VERIFY 
EOF 
SAVRTN 
FLDLEN 
TEFEND 
TABEND 
TABLEN 
BL INK 
DTEN 
RELREC 
TEMARK 
INFILE 


OUTFLE 


OPTION 
INBUFF 
FNAME 
LNAME 
OUTRUF 
HLDTAB 
MYREG 


erreranr. 


DEF 

REF 

EGU 

EQU 

EQU 

EGU 

EGU 

ECU 

BYTE 
EYTE 
BYTE 
EVTE 
BYTE 
EYTE 
BYTE 
EYTE 
BYTE 
EVEN 
DATA 
DATA 
DATA 
DATA 
DATA 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
TEXT 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
TEXT 
DATA 
TEXT 
BSS 

ESS 

EQU 

EU 

ESS 

ESS 

ESS 


DI "SORT" A FAG. 79 
SORT 

VMEW, VSBW, VUTR, VMER, ESC 
>8375 

»B37C 

>F80 


| >FAO 


#1000 
6356 
201 
203 
>O2 
»OD 
+08 
#09 
21E 
06 
205 


FOO7E y 34242,4242,7E00 
2PFFFF, 22020, >2020, *20Z0 
+Z0Z0, SZ020, >Z2020, >2020 
2020, 32020, 22020, #2020 
FOZO2, *2020, 2020, >FFFF 
1/0 ERROR !' CODE= i 
‘ Chapter 10 Sort Frogr 
‘ Output File/Device Na 
Sorting Now 
Ù End Of Job 
‘. Fress Any key To Con 
Record Count 
‘======Input===0Output== 
«A*scend «D>escend 


* What Field # To Sort 
First Name----------- 
Last Name----------- 
Screen Complete - Red 
20000 

30000 

>000E 

#000D 

2000F 

20010 

>OBAO0 

>000A 

20000 

>FFFF 

20005, RECBUF, >5050, 2000 
‘DSK1.FILEI1 

20003 , RECBUF, 35050, >000 
‘DSK 

2 

80 

INBUFF 
INEUFF+14 
80 

210 


>2 053 


© 4 .5. 0. n 


AN, DSRLNK, VSER 


am 
me? 


tinue 


— cer dif dnse ceo e LA 
dat44T 


>» . 
On > î 
i a 1 Li 
—--2 
o? ° 
O, 2O00A 


0, >0000 


BSs s1000 


060 SORT 
061 
062 
063 
064 
065 
066 LOOFI 
067 
0658 
O69 
O7O0 
O71 
072 
O73 
074 
O75 


076 FROMFT 


077 
078 
O79 
080 
O81l 
092 
OBI 
084 
OE 
OB 
087 
088 
089 
090 


091 WHTFLD 


092 
093 
094 
0975 
096 
097 
098 
099 
100 
101 
102 
103 
104 
105 
106 
107 
108 ORDER 
109 
110 
1ll 
112 
115 
114 
115 
116 
117 
118 
119 VERIF 
120 
121 
122 
125 
124 


125 


MOV 
LWFI 


BLWP 
LI 
LI 
BLWF 
INC 
CI 
JLT 
LI 
ELWF 
LI 
LI 
LI 
BLWF' 
BL 
LI 
LI 
ELWF 
LI 
LI 
BLWF° 
LI 
LI 
E:L 
MOV 
LI 
LI 
MOV 
BLWP 
LI 
LI 
LI 
ELWF' 
LI 
LI 
BLWF 
LI 
LI 
BLWF 
LI 
LI 
EL 
CI 
ILT 
CI 
JGT 


BLWP 


JEQ 


BLWP 


Rii, @ESAVRTN 


MYREG 
RO, >0766 
EVWTR 
RO, >0380 
R1,}F400 
-@VSBW 
RO 
RO, 3039F 
LOOF1 
R1, 6600 
| @VSBW 
RO, >OBFO 
R1,CURPAT 
R2,8 
© @VMBW 
@SCREEN 
KO, 66 
Ri,TIT1 
__ EVMEW 
RO, 130 
RI,TIT2 
C'WMEW 
RO, 195 
R10,15 
@CURSOR 


Salva l'indirizzo di ritorno 
Carica il puntatore al workspace 
mette il colore del bordo al Rosso scuro 


Mette il set dei caratteri come Bianco/Bl 


Mette il carattere del bordo al Rosso 


Carica il pattern del cursore 


Visualizza il titolo del programma 


Frompt per il dispositivo di output 


Ottiene il nome del dispositivo di output 


R7,@@E0UTFLE+8 Muove il descrit. lungh. del file al FAB 


RO, 195 


Ri ,OUTFLE+10 


R7,R2 
@VMBR 
RO, 258 
Ri WATFLD 
R2,28 
@VMEW 
RO, 290 
Ri ,FIELDI 
EVMEW 
RO, 322 
R1,FIELD2 
EVMEW 
Ri0,1 
RO, 282 
- €CURSOR 
R9, }3LOO 
WHTFLD 
R9, 3200 
WHTFLD 
RO,418 
R1i,ORDI 
IEVMBW 
RI0,1 
RO, 443 
:@CURSOR 
R9, 34100 
ORDER 
VERIF 
R9, >4400 
ORDER 
RO, 706 
R1,VERIFY 
:@VMBW 
RIO 
@CURSOR 
RO, 443 
;@VSER 


Legge il nome dispositivo nel FAB 
Cuale campo da classificare? 


Ottiene la scelta del N° campo 
Verifica se la risposta è = a "1" o "2 


Altrimenti, ancora il prompt 


Frompt per l'ordine "Ascend/Discend"? 


Ottiene la scelta dell'ordine 
Verifica se la risposta è = "A"o "D" 


Altrimenti, di nuovo il prompt 


Verifica le scelte fatte 


126 
127 
128 
129 
130 
151 


ho 


"=" 


pad a 
DIA TAC 4 AL 
DS OOMONOSUÌDÌ 


fd i pi 


(I 
s A 
Ma 


1453 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
155 
164 
165 
166 
167 
169 
169 
170 
171 
172 
175 
174 
175 
176 
177 
178 
179 
1890 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 


READ 


MOVLNM 
MOVS 


DONE1 


COMF'AR 
GETTAB 


ORDCHK 


MOVE 
LI 
BLWF 
MOVR 
LI 
LI 
LI 
BLWF' 
BL 
MOVE 
ELWF' 
BL 
LI 
LI 
BLWF' 
LI 
LI 
BLWF' 
LI 
MOV 
CLR 
LI 
LI 
LI 
BLWF' 
MOV 
LI 
LI 
BL 
BL 
MOV 
JNE 
LI 
LI 
LI 
ELWF 
LI 
CE 
JNE 
LI 
JMF 
LI 
BL 
MOV 
JMF 
MOV 
LI 
LI 
LI 
ELWF 
LI 
LI 
BLUP 
LI 
LI 
MOV 
MOV 


MOV 
JE 
MOV 
MOV 


JE 


Ri, GOFTION 
RO,282 
EVSER 

R1, 
RO,FABIN 
RI, INFILE 
R2,2 

GVMEW 
@EDSRIN 
EREADE,RI1 
EVESEW 
I@SCREEN 
RO,256 
Ri,TOT1 
@VMEW 
R1,258 

RO, TOT2 
@VMBW 
RE, SRTTAB 
EFLDLEN,R9 
. €E0F 
RO,FABIN+6 
Ri ,RELREC 
R2E,2Z 

:€VMBR 
:@ERELREC,R4 
R3,295 

RO, 300 

GF IGUR 
‘@DSRIN 
:@EOF, EGEO0F 
DONE i 

RO, RECBUF 
Ri, INBUF 
R2,80 
@VMBR 

R1I, 23100 


R1,@GOFTION+1 


MOVLNM 
R7,FNAME 
MOVS 

R7, LNAME 
@MOVWRD 


@RELREC,*RB+ Carica il N° 


READ 


Salva l'ordine dell'opzione 


GOFTION+1 Salva il campo opzione 


Stabilisce il FAB file input 


Apre in modo input 


Mette la lettura del’'0F/CODE 
Ritorna allo schermo grafico 


nel FAE+O 


Visualizza l’intestazione del cont. record 


Destina l'indirizzo per muovere la Word a Rtr 
Lunghezza del campo per muovere la Word a Ri 


Indirizzo FAE del N° record 


Ottiene il numero del record relativo 


Visualizza il contatore di record input 
Legge un record 
Controlla per la fine del file 
Se è EOF vai a "DONEI" 
Indirizzo del buffer VDP RAM 
Indirizzo del buffer CPU RAM 
Lunghezza del record 
Ottiene un record 
Controlla per quale campo 


Indirizzo del primo nome per MOVWKD 


Indirizzo dell'ultimo nome per MOVWRD 
Esequire MOVWRD - Carica la tavola del sort 
del record relat. nella tavola 
Legge un altro record 


16€TEMARK,*R8 Carica la fine della tavola indicatrice 


RO, 322 

Ri, EGLN 
R2,28 
EVMEW 
RO,3S4 
RI,TIT3 
-@VMBW 

RS, >4400 
Ri, SRTTAB 
Ri,R3 

R1,R2 
@TBFEND,R2 
R3,R4 
@TABLEN,R4 


.@€TBMARK, *R4 


DONE2 
R3, RO 
RA,RI 
RS, :GOPTION 
CLOFD 


Visualizza "Adesso classifico" 


Carica R4 con il valore di "D" 
Indirizzo della prima entrata nella tavola 
Muove il valore dell'indirizzo da Rl a R3 
Muove il valore dell'indirizzo da RI a R2 
Calcola la lunghezza dell'entrata nella tavo] 
Calcola l’indir. della pross., entr. tavola 
Controlla per la fine della tavola 
Se è la fine della tavola, vai a DONE2 
Salva l'indirizzo di "A" in RO 
Salva l'indirizzo di "B" in Ri 
Controlla per Ascend/Descend 


* 


* ORDINE ASCENDENTE * 


» 
192 CLOP 
195 

194 

195 

196 

197 

* 


C 
JEQ 
CB 
JEQ 
JGT 
JMF 


R3,R2 
GETTARB 
*R3+,*R4+ 
CLOP 

SWIT 
GETTAB 


* ORDINE DISCENDENTE * 


* 

198 CLOFD 
199 

200 

201 

202 

203 SWIT 
204 

205 

206 

ZO7 

208 

209 

ZIO 

ZII 

212 


213 


214 MOVWKD 


215 
216 MOVEM 
217 
218 
219 
220 DONE2 


ma 


din do 


ninni 
PA 


FIENO 


di dio ‘a 


me 
224 
ten Lan] — 
dis dia 
uri 
na 
cdi dio 
FICA 
228 
Mo 
do do 
mer. 


ped] () 


miri 
prot, 


ATA 
FAI 


dio St cn 

n 

La ‘n 

2z5 GETRR 
mae 

di ‘e 


237 
238 


mv 
poscia) 


240 
241 
242 
243 
244 
245 
246 
247 
248 
249 


290 
me 
dr 


C 
JEO 
CB 
JEO 
JGT 
MOV 
LI 
MOV 
EL 
MOV 
MOV 
BL 
LI 
MOV 
EL 
JMF 
MOV 
A 
MOV 
C 
JINE 
RT 
CLR 
LI 
LI 
LI 
ELWF 
BL 
MOVE 
BLWP 
LI 
LI 
BLWF' 
BL 
MOVE 
BLWP 
LI 
MOV 
S 

C 
JEC 
MOV 
LI 
LI 
BLWF' 
BL 
INC 
BL 

A 
MOV 
LI 
LI 
BL 
JMP 


R3,R2 
GETTAR 
*R3+,*R4+ 
CLOF'D 
GETTAB 
R1,R7 
R8,HLDTAB 


‘@ETABLEN,R9 


@EMOVWRD 
RO,R7 
F1,R8 

EMOVWRD 
R7,HLDTAE 
RO,R8 

@EMOVWKD 
COMFAR 
R9,R6 
R7,R6 
*R7+,*RB+ 
R7,F6 
MOVEM 


R9 
RO, FABOUT 
Ri JOUTFLE 
R2, 25 
‘EVMEW 
@DSROUT 


@WRITE,RI 


.@VSEW 
RO,FABIN 
Ri, INFILE 
‘’@VMBEW 
‘@DSRIN 


G@READE,R1 


:EVSBW 


RB8,SRTTAB+14 


R8,R4 


. @FLDLEN,R4 
@TBEMARK, *R4 


E0J 
Re,R1 


RO,FABIN+6 


R2,2 
EVMBW 
EDSRIN 

R9 
@DSROUT 


ETABLEN,FR8 


R9,R4 
13,304 
RO, ZO9 
@FIGUR 
GETRR 


Controlla per l’ultimo byte del campo 

Se =, ottiene la prossima entrata della tavo 
Confronta un byte di "A" con "E" 

Se è uguale, ripetere 

Se A > E, interrompere 

Se A < B, allora ottenere la prossima entrat 


Controlla per l’ultimo byte del campo 
Se uguale ottiene la prossima entrata 
Confronta un byte di "A" con "E" 
Se è uguale, ripetere 
Se A > E allora ottiene la prossima entrata 
Carica R7 con l'indirizzo di "B" 
Carica R8 con l'indirizzo HLDTAB 
Carica R9 con la lunghezza da muovere 
Muove "E" nell’area di appoggio 
Carica l'indirizzo di "A"d 
Carica l'indirizzo di "E" 
Muove "A" a "E" 
Carica l'indirizzo di appoggio 
Carica l'indirizzo di "A" 
Muove l’appoqgaio di (E) ad "A" 
Ritorna indietro e control. la seg. della ta 
Carica la lunghezza da muovere 
Calcola il massimo indirizzo 
Muove una Word, e incrementa l'indirizzo 
Controlla per l'indirizzo massimo 
Se non è il massimo, muovi ancora 
Altrimenti, ritorna 
Fulisce il registro 9 
Stabilisce il file output nel FAB 


Apre il file output 
Mette l’op-code della scrittura nel FAB+O 


Ristabilisce il file input nel FAB 


Apre il file input 
Mette l’op-code della lettura nel FAB+O 


Indirizzo nella tav. del N° del rec.rel, 
Muove l'indirizzo in R8 a R4 
Calcola l'indirizzo della prima entrata 
Controlla per la fine della tavola 
Se è la fine della tavola, vai a EDJ 
Muove l'indirizzo del N° del rec. rel. a Ri 
Carica RO con l’indirizzo di destinazione 
Carica R2 con la lunghezza dei dati 
Mette il N° del record rel. nel FAB+6 
Legge questo record 
Incrementa il contatore dei record output 
Scrive un record output 
Calcola l'indirizzo del prossim rec. relati 
Muove il contatore dei record a R4 


Visualizza il contatore dei record output 
Ottiene il prossimo N° del record relativo 


men 
pe Pe 


255 
254 
29 

256 
25 

258 
29 

260 
261 
26 
263 
264 
265 
266 
267 
268 
269 
279 
271 
272 
275 
274 
279 
276 
277 
278 
279 
2890 
"81 
222 
283 
284 
2895 
286 
287 
288 
289 
290 
291 
292 
2935 
294 
295 
296 
297 
298 
299 
Z00 
301 
SOZ 
SOT 
304 
305 
306 
307 
308 
309 
10 
Sil 
312 
313 
314 
315 
16 
317 


EOJ 


EOJX 


EOJO 


TX 
CURSOR 


CURFUT 


CURL1 


CURL2 


DETECT 


LI 
LI 
LI 
BLWF 
LI 
LI 
BLWF' 
LI 
MOVE 
BLWF 
LI 
BLWF' 
BL 
BL 
CLR 
EL 
CLR 
MOV 
RT 
CLR 
CLR 
CLR 
MOV 
JE 
MOV 
Fi 
MOV 
CLR 
MOV 
LI 
BELWF 
BLWP 
MOVE 
JNE 
AI 

C 
ILT 
MOV 
JEO 
CLR 
MOVE 
ELWF 
INC 
C 
JLT 
JMF 
CE 
JE 
CB 
JEQ 
MOV 
JEO 
CE 
JEO 
CB 
JE 
CB 
JEC 
C 
JEGQ 
MOV 
MOVB 
MOVB 
BELWP 
INC 
JMP 


RO, 354 Visualizza "END OF JOB" = ( fine del lavoro) 
Ri,TIT4 
R2,28 
@VMBW 
RO,706 
RI,TITS 
:EVMEW 
RO,FABIN 
@ECLOSE,Ri Mette l’'op-code di close nel FAB+O 
.@VSEW 
RO, FABOUT Mette l’'op-code di close nel FAB+O 
‘*»@VSEW 
.@DSRIN Chiude il file input 
‘EDSROUT Chiude il file output 
RIO 
.€CURSOR Esegue un "FRESS ANY KEY" 
‘ ESTATUS Fulisce il byte dello Status GFL 
@SAVRTN,Ri1i Muove l'indirizzo di ritorno in RII 
Ritorna (E #*R11) 
R9 Fulisce il registro 9 
SKEYVAL Fulisce l’indir. del valore del tasto prem. 
eSTATUS Fulisce il byte dello status GFL 
RIO,RIO Controlla R10 per il valore di zero 
CURL i Se è zero, vai al LOOF1 cursore 
RO,R8 Salva l'indirizzo di inizio del cursore 
RB,R10 Calcola l'indirizzo massimo del cursore 
R8,R7 Muove l'indirizzo iniziale all’'accumulatore 
Rb6 Pulisce il registro é6 
R7,fR0 Muove l’accumulatore in RO 
Ri, 72000 Carica il registro i con lo spazio 
+ €EVSEW Visualizza lo spazio 
.@ESCAN Esegue la scansione della tastiera 
.€ESTATUS, @STATUS Controlla il tasto battuto 
DECTET Se il tasto è premuto, quale tasto?” 
R6,4 Addiziona 4 al registro 
R6, .EBLINK Confronta Ré con il contatore BLINK 
CURL 1 Se minore, ripeti CURLI 
RIO,R1O0 Controla RIO con il valore zero 
CURL 1 Se è zero, vai a CURLI 
R6 Fulisce il registro é 
@CURVAL,R1 Muove il codice del cursore in RI 
:EVSBW Visualizza il cursore 
R6 Addiziona i a Ré 
R6, 'EBLINK Confronta Ré con il contatore di BLINK 
CURL2 Se è minore, ripeti CURL2 
CURFUT Ripetere il ciclo del cursore 
GREDOV, :@FEYVAL : Controlla per il valore di "REDO" 
REDOX Se REDO, vai all'uscita REDO 
@QUITV, @KEYVAL Controlla per il valore di "QUIT" 
EOJO Se QUIT, vai a EDJ/QUIT 
RIO,RIO Controlla RIO con il valore zero 
XT Se è zero, ritorna 
I@EENTV, @KEYVAL Controlla per il valore di "ENTER" 
ENTER 
‘ELEFTV,''EKEYVAL Controlla per. la freccia sinistra 
LEFT Downloaded from www.ti99iuc.it 
. @RITEV, EKEYVAL Controlla per la freccia destra 
RITE | 
R7,R10 Controlla per il massimo indirizzo del curs, 
CURFUT Se è uquale, vai a “"CURFUT" 
R7,FR0 Muove il nuovo indirizzo in RO 
-@KEYVAL ,RI1 Muove il valore del tasto premuto in RI 
I@EFEYVAL ,R9 Salva il valore del tasto premuto in R9 
:@EVSBW Visualizza il carattere del tasto premuto 
R7 Addiziona i all’accumulatore dell'indirizzo 
CURPUT Vai a "CURFUT" 


18 
219 
320 
21 
22 


edera 
sla 


74 
‘4 


sac 


Sen” dio 


Z26 
227 
328 
329 
50 


- 
del 
= 
cain 
we 
salt 0! 


224 
335 


336 
337 
338 
339 
340 
341 


LEFT 


RITE 


ENTER 


5 REDOX 


SCREEN 


SCRL 


LEAVE 


RTN 
DSRIN 


DSROUT 
DSR 


ERROR 


FIGUR 


C 
JEG 
MOV 
LI 
BLWF 
DEC 
JMF 


JE 
INC 
JMF 
LI 
MOV 
BLWF' 


JEQ 
RT 


CLR 
LI 
LI 
ELWF 
CI 
JHE 


AI 
JMP 
LI 
LI 
LI 
BLWF 
LI 
BLWF 
RT 
LI 
JMF 
LI 
MOV 
ELWF' 
DATA 
JNE 
MOV 
AI 
BELWFP 
SRL 
MOV 
CE 
JEO 
BL 
MOV 
INC 
LI 
LI 
BLWP 


BLWF 
MOV 
AI 
LI 
BELWP 
LI 
LI 
BLWP 


MOV 
CLR 


R7,R8 
CURPUT 
R7,RO 
Ri, >2000 
@EVSEW 
R7 
CURFUT 
R7,R10 
CURFUT 
R7 
CURPUT 
Ri, 32000 
R7,RO 

| @VSEW 
R8,R7 
CURSOR 


:@PROMFT 

RO 

Ri, BORDER 

R2, 32 
@VMEW 

RO,736 
LEAVE 


RO, 32 
SCRL 
RO,2 
Ri, EGLN 
R2,28 
@VMBEW 
RO, 738 
@VMEW 


Rb£,FABIN+9 
DSR 
F6,FAEOUT+9 
R6, EFNTR 
@EDSRLNK 

8 

RTN 

R6.,RO 
RO,-8 
@EVSER 
R1,5 
R1,@E0F 
EQUITV.,RI 
RTN 
ESCREEN 
R6  , Ro 

RO 

Ri, INBUFF 
RZ, Z0 
EVMBR 

RO, 259 
EVMEW 
GEOF ,RI 
R1, 23000 
RO, 343 
@EVSEW 

RO, 322 
R1,ERRMSG 
@VMEW 
CEEOJX 
R4,R5 

R4 


Controlla per il minimo indirizzo del cursore 
Se è uquale, vai a "CURFUT" 
Muove all'indirizzo corrente in RO 
Carica R1 con il codice del caratt. spazio 
Scrive uno spazio all'indirizzo corrente 
Sottrae 1 dall'indirizzo corrente 
Vai a "CURFUT" 
Controlla per l'indirizzo massimo del cursore 
Se è uguale,vai a "CURFUT" 
fddiziona 1 all'indirizzo corrente 
Vai a "CURFUT" 
Carica Ri con il codice del carattere spazio 
Muove l'indirizzo corrente in RO 
Lo spazio sopra il simbolo del cursore 
Calcola l’efettiva lunghezza dei dati 
Se è zero, ripeti il ritorno al cursore 
Altrimenti ritorna 
Si dirama all'indirizzo di 
Fulisce il registro O 
Carica RI con l'indirizzo del bordo 
Carica R2 con la lunghezza dei dati 
Scrive una linea del pattern 
Confronta RO con il massimo valore 
Se = o >, vai a "LEAVE" 


"PROMPT" 


Addiziona 32 a RO 

Vai a "SCRL" 

Carica RO con il valore di 2 

Carica RI con l'indirizzo grafico 

Carica R2 con la lunghezza della linea 
Visualizza all'indirizzo dello schermo 2 
Carica RO con il valore 7358 

Visualizza all'indirizzo 738 dello schermo 
Ritorna 

Carica Ré con l'indirizzo FAB 


Carica Ré con l'indirizzo FAE 

Muove Ré all'indirizzo del puntatore 

esegue un ritorno al dispositivo di servizio 
Se nessun errore, ritorna 

Muove Ré in RO 

Calcola l'indirizzo del byte 1 del FAB 
Legge il byte i del FAB in RI 

Sposta Ri a destra di S posizioni 
Muove Ri nel "FLAG"dell’'EOF 
Controlla per EOF (valore di 
Se è uguale, ritorna 
Altrimenti, rifare lo schermo grafico 

Muove R6 in RO 

Calcola l'indirizzo del byte 10 del FAB 

Carica Ri tempor. nell'indirizzo in CPU RAM 
Carica R2 con la lunghezza da scrivere 

Ottiene il nome del file in ERROR 

Carica RO con l'indirizzo di schermo 259 
Visualizza il nome del file in ERROR 

Muove il codice di errore in Ri 

Crea un numero ASCII 

Indirizzo di schermo per il codice di errore 
Visualizza il codice di errore 

Indirizzo di schermo per il messaggio d'’errore 
indirizzo del messaggio’ 

Visualizza il messaggio di errore 

Vai a EOJ 

Muove R4 in RS 

Fulisce R4 


205) 


Ri 
84 
BS 
86 
287 
88 
389 
290 
291 


z92 


DIV 
AI 
SLA 
MOV 
BLWF 
DEC 


INE 
RT 
END 


EDTEN,R4 
RS, >3O 
RS,8 
RS,R1 
@VSEW 

RO 

RO,RS3 
FIGUR 


Divide R4/RS di dieci 

Crea un numero ASCII in RS 
Sposta RS a sinistra di 8 posti 
Muove RS in RI 

Visualizza una cifra 

Sottrae i da RO 

Confronta RO con RI 

Se non è uguale, ripeti 
Altrimenti, ritorna 


0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 
0029 
0030 
0031 
00352 
06033 
0034 
0035 
0036 
0037 
0038 
00359 
0040 
0041 
0042 
0043 
0044 
0045 
0046 
0047 
0048 
0049 
0050 
0051 
0052 
0053 
0054 


FPAC 
SBUFF 
LBUS 
LIM 
60 


XT 
GETNUM 


CHELMC 


CHKLMR 


CHK 


ERROR 


PRINT 


PLOOP 


** SOTTOFROGRAMMA 


DEF 
REF 
EQU 
BSS 
BSS 
DATA 
MOV 
CLR 
LI 
BL 
BL 
MOV 
DEC 
SLA 
MOV 
INC 
BL 
BL 


INC 
INC 
LI 
SETO 
BLWP 
CLR 
MOV 
MOVB 
JEQ 
SWPB 
BL 


BLWP 
ELWP 
DATA 


JGT 
JMP 


JG6T 


JLT 


LI 
BLWP 
MOV 
LI 
AI 
MOV 
MOVB 
AB 
BLWP 
INC 
DEC 


60 


"DISFLAY AT" x* FAG. 99 


VSBW, VMEW, VMBR, NUMREF, XMLLNK,STRREF,ERR 


>854A 
250 
352 


>0001,20018,2001C 


RI1,RIO 
RO 
Ri,1 
.@GETNUM 
@CHKLMR 
.@FPAC,R4 
R4 
R4,5 
R4,R7 
RI 
@GETNUM 
@CHKLMC 
@FPAC,RA 
R4 
RI 
R2,5BUF 
@SBUF 
:@STRREF 
RS 
R2,R3 
+R34,R5 
XT 
RS 
EPRINT 
#R10 
@NUMREF 
@XMLLNK 
>1200 
#Ri1 
:@FPAC, @LIM+4 
ERROR 
CHK 
@FPAC, @LIM+2 
ERROR 
_@FFAC, :@LIM 
ERROR 
*Rii 
0,>1300 
.@ERR 
R11,9 — 
R6,>6000 
R7,30 
R4,RO 
*R3+,R1 
R6,RI 
@VSBWH 
R4 
RS 


Definisce il buffer di stringa 
Definisce il buffer di linea 
Definisce l'area delle righe e colonne 
Salva l'indirizzo di ritorno 
Pulisce RO - NUMREF Paran. N°1 
Inizializza RI con 1 - NUMREF Param. N°2 
Ottiene la prima variabile (numero riga 
Controlla i limiti della riga 
Muove il valore della riga in RA4 
Aggiusta per l1'ASSEMBLY 
Moltiplica la riga per 52 
Muove l'indirizzo riga in R7 
Incrementa Ri per il prossimo paran. 
Ottiene la seconda variabile (numero Coc) 
Controlla i limiti della colonna 
Addiziona il valore riga 
Aggiusta per il BASIC 
Incrementa RI per il prossimo parametro 
Carica R2 con l'indirizzo del buffer strivéA 
Inizializza la prima Word con >FFFF 
Ottiene la terza variabile (la stringa) 
Fulisce RS (il contatore dei byte) 
Muove l'indirizzo di SBUF in R3 ì 
Ottiene il priao byte (lunghezza stringa, 
Se la lunghezza stringa è uguale a zero, Sacîa A4_XT 
Cambia i byte di RS (aggiusta a sinistra 
Visualizza la stringa 
Ritorna al programma chiamante 
Ottiene il numero base (in virgola mobivs ) 
Esegue la conversione Virg. Mob./intero 
Indirizzo della routine XML 
Ritorna 
Confronta l’intero con 28 
Se è maggiore, salta a "ERROR" 
Salta a “"CHK” 
Confronta l’intero con 24 
Se è maggiore, salta a "ERROR" 
Confronta l’intero con 1 
Se è minore, salta a "ERROR" 
Ritorna 
Carica RO col valore del messaggio d'’erQdai 
Si dirama alla routine del messag. d'’era4244 
Salva l'indirizzo di allacciamento 
Carica Ré con il valore offset dello schcaano? 
Calcola il prossimo indirizzo di riga 
Muove l'indirizzo del VDF in RO 
Ottiene un byte dal buffer di stringa 
Addiziona l’offset dello schermo a RI 
Scrive un byte 
Punta all'indirizzo del prossimo schermo 
Decrementa il contatore dei caratteri 


0055 
OCSÒì 
0057 
0058 
0059 
0060 
0061 
0062 
00653 
0064 
0065 
0066 
0067 
0068 
0069 
0070 
0071 
0072 
0073 
0074 
0075 
0076 
0077 
0078 
0079 
0080 
0081 
0082 
0083 
0084 
0085 
(0I41:1-, 


LI 


SCROLL 


L4 


LI 


NP 


JNE 


JL 
AI 
AI 
CI 
JLE 
BL 
AI 
AI 
JMP 
LI 
LI 
LI 


BLWP 
AI 
CI 
JLT 
JEQ 


MOV 
MOV 
LI 
MOV 
DECT 
JINE 
ELWP 
JMP 
END 


Li 
#R9 
R4,R7 
PLOOP 
R7,3 
R4,4 
R7,766 
PLOOP 
ESCROLL 
R7,-32 
R4,-3 
PLOOP 
R0,-32 
Ri, LBUF 
R2,32 
R0, 64 
@VMEW 
R0,-32 
R0,>2E0 
NP 
Si 
«Ri1 
RI,R13 
R2,R14 
R15,)2020 
R15,#R13+ 
R14 
L3 
- @VMBW 
LA 


Se RS non è uguale a 0, salta a LI 
Ritorna 
Confronta il nuovo indirizzo con il Limirz: 
Se è minore, salta a "PLOOP* 
Altrimenti incremen. il limite di 1 riga 
Incrementa l'indirizzo dello schermo di 4 
è la nuova riga dello schermo 
Salta a PLODP 
Si dirama a SCROLL 
Aggiusta il limite dopo lo scroll 
Aggiusta l'indirizzo schermo dopo lo scrott 
Salta a PLOOP 
Inizializza l'indirizzo dello schermo 
Carica Ri con l'indirizzo buffer di linea 
Carica R2 con la lunghezza della linea 
Si muove sotto di una linea 
Legge una linea nel buffer di linea 
Si muove in su di una linea 
è questa l’ultima linea? 
Se non la è, salta a "NP" 
Se la è, salta a "SI" 
Lo scroll è fatto, ritorna 
Copia il puntatore del buffer 
Copia la lunghezza del buffer 
Carica due spazi in RIS 
Muove gli spazi nel buffer 
Decrementa il contatore dei byte 
Frossima Word in PAD 
Scrive più byte 
Salta a R4 
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